Basilisp nREPL MCP Bridge

Basilisp nREPL MCP Bridge

このプロジェクトは、Anthropic の Model Control Protocol（MCP）と Basilisp の nREPL サーバーをつなぐブリッジを提供し、Claude Code が Basilisp REPL と直接やり取りできるようにします。 実際には、どの nREPL でも動作するはずですが、現在のプロンプトは Basilisp に特化しています。

機能

• コードを実行し、整形され、構文が強調表示された結果を取得します
• シンボルのドキュメントを取得します
• 利用可能なすべての名前空間を一覧表示します
• 名前空間内のすべての変数を検索します
• nREPL サーバーへの接続を確認します
• Basilisp：属性アクセスやメソッド呼び出しに適した構文で Python との相互運用を行います
• エラー報告とフォーマットを強化します

要件

• uv
• basilisp

使い方

1. Basilisp nREPL サーバーを起動します：

   basilisp nrepl-server --port 36915
   

2. MCP ブリッジを Claude Code に追加します：

   claude mcp add /home/a/subjective/snr/basilisp_mcp_bridge.py
   

3. Claude に接続し、利用可能なツールを使用します：

   • eval_code(code) - Basilisp コードを評価します
   • get_docs(symbol) - シンボルのドキュメントを取得します
   • find_namespace_vars(namespace) - 名前空間内の変数を一覧表示します
   • list_namespaces() - 利用可能なすべての名前空間を一覧表示します
   • check_connection() - nREPL への接続を確認します

Python との相互運用の例

;; Import a module
(import [math :as math])

;; Access an attribute
(. math -pi)  ;; or (.-pi math)

;; Call a method
(.sin math 0)

;; Create Python data structures
#py{"key" "value"}

今後の改善点

• 正規表現に頼らない、適切な bencode パーサーを実装します
• 複数の REPL を扱うためのセッション管理を追加します
• 自動補完のサポートを追加します