Bmorphism Babashka MCP Server

🚀 Babashka MCP サーバー

このサーバーは、Babashka（スクリプト作成用のネイティブClojureインタープリター）とのやり取りを可能にするModel Context Protocol (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 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ユーザーフォーラム