Bmorphism Babashka MCP Server

🚀 Babashka MCP 服務器

本項目是一個用於與 Babashka（一種用於腳本編寫的本機 Clojure 解釋器）交互的 Model Context Protocol (MCP) 服務器，能夠藉助 MCP 工具執行代碼並提供一系列便捷功能。

🚀 快速開始

本服務器可實現與 Babashka 的交互，通過 MCP 工具執行代碼，還具備結果緩存、命令歷史記錄訪問等功能。使用前需確保 Babashka 已正確安裝並配置。

✨ 主要特性

• 通過 MCP 工具執行 Babashka 代碼
• 緩存最近命令的結果
• 通過 MCP 資源訪問命令歷史記錄
• 配置命令超時時間

📦 安裝指南

安裝 Babashka

Babashka 可以通過多種方式安裝：

macOS

brew install borkdude/brew/babashka

Linux

bash < <(curl -s https://raw.githubusercontent.com/babashka/babashka/master/install)

Windows

# 使用 scoop 安裝
scoop install babashka

有關其他安裝方法，請參見 Babashka 官方安裝指南。

驗證安裝

安裝完成後，驗證 Babashka 是否正常工作：

# 檢查版本
bb --version

# 測試簡單表達式
bb -e '(+ 1 2 3)'

# 運行從字符串傳遞的腳本
bb -e '(defn hello [x] (str "Hello, " x "!")) (hello "World")'

# 使用 -i 標誌處理輸入行
ls | bb -i '(take 2 *input*)'

安裝服務器

# 安裝依賴項
npm install

# 構建 MCP 服務器
npm run build

📚 詳細文檔

配置

服務器可通過環境變量進行配置：

• BABASHKA_PATH：Babashka 可執行文件的路徑（默認值： "bb"）

工具

execute

帶有可選超時時間的 Babashka 代碼執行：

{
  name: "execute",
  arguments: {
    code: string;      // 要執行的 Babashka 代碼
    timeout?: number;  // 超時時間（單位：毫秒，默認值：30000）
  }
}

示例：

{
  name: "execute",
  arguments: {
    code: "(+ 1 2 3)",
    timeout: 5000
  }
}

資源

服務器維護一個緩存的最近命令執行結果，可通過以下方式訪問：

• babashka://commands/{index} - 按索引訪問特定命令的結果

Babashka 語言功能

尾調用優化 (TCO)

Babashka 支持通過 recur 特殊形式實現顯式尾調用優化，但不支持自動 TCO。例如：

;; 這會導致堆棧溢出
(defn countdown [n]
  (if (zero? n)
      "done"
      (recur (- n 1))))

;; 支持的實現
(defn countdown [n]
  (loop [n n]
    (when (> n 0)
      (println n)
      (recur (- n 1)))))

參考文獻

有關 MCP 協議和 babashka 的更多信息，請參考：

• MCP 官方文檔
• Babashka 官方網站

如果遇到問題或有改進建議，請通過以下方式聯繫：

• 郵件：support@babashka-project.org
• 論壇：Babashka 用戶論壇