Babashka MCP Server

🚀 Babashka MCP 服務器

Babashka MCP 服務器是一個與 Babashka 交互的 Model Context Protocol (MCP) 服務器。Babashka 是用於腳本編寫的原生 Clojure 解釋器，本服務器為其提供了便捷的交互方式。

✨ 主要特性

• 🛠️ 通過 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 factorial [n]
  (if (= n 0)
    1
    (* n (factorial (- n 1)))))

(factorial 500)

;; 使用 recur 避免棧溢出
(defn factorial [n]
  (defn helper [n acc]
    (if (= n 0)
      acc
      (recur (- n 1) (* acc n))))
  (helper n 1))

(factorial 500)

未來發展

Babashka 的未來計劃包括：

• 支持多線程和併發執行。
• 提供更高效的代碼執行方式。
• 增強的錯誤處理機制。
• 更好的調試和診斷工具。