Babashka MCP Server

🚀 Babashka MCP サーバ

Babashka と相互作用する Model Context Protocol (MCP) サーバです。Babashka は、スクリプト作成に使用されるネイティブの Clojure インタープリターです。

🚀 クイックスタート

このサーバは、Babashka とのやり取りを可能にする MCP サーバです。以下の手順でサーバをセットアップし、使用することができます。

✨ 主な機能

• 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 の将来の計画には以下が含まれます。

• マルチスレッドと並列実行のサポート
• より効率的なコード実行方法の提供
• 強化されたエラー処理メカニズム
• より良いデバッグと診断ツール