Clojure Nrepl

🚀 nREPL MCP サーバー

このサーバーは、Model Context Protocol (MCP) クライアント、例えば Claude Desktop や VSCode の CLine 用に設計されています。このサーバーは、（CLine を通じて使用する場合）任意の LLM と一緒に使用できます。また、実行中の Clojure nREPL インスタンス とやり取りすることができ、指定された名前空間または現在の名前空間で Clojure コードを評価したり、名前空間を調べたりするなどの便利な機能を提供します。

🚀 クイックスタート

このサーバーは、MCP クライアントと連携して使用することができます。以下のセクションでは、インストール方法や操作方法について説明します。

✨ 主な機能

• 実行中の nREPL サーバーに、ホストとポートを指定して接続します。
• 指定された名前空間または現在の名前空間で Clojure コードを評価 します。
• tools.namespace を使用して、プロジェクトの名前空間を一覧表示 します。
• nREPL の接続状態 を取得します。これには、ホスト、ポート、セッションの詳細が含まれます。
• 公開変数を調べ、任意の Clojure 名前空間内のメタデータ（ドキュメント文字列や値など）を取得します。

📦 インストール

CLine (VSCode) または Claude Desktop でのインストール

このサーバーを CLine または Claude Desktop と一緒に使用するには、以下の手順に従ってください。

1. VSCode の CLine または Claude Desktop を開きます。
2. MCP 設定 に移動します。
3. 新しい MCP サーバーを追加し、以下のように設定します。

   {
     "mcpServers": {
       "nrepl-mcp-server": {
         "command": "npx",
         "args": [
           "nrepl-mcp-server"
         ],
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

4. 変更を適用するために、設定を保存してクライアントを再起動します。

これにより、クライアントは標準入出力を介して nREPL MCP サーバーと通信できるようになります。

npx を使用したインストール

リポジトリをクローンすることなくサーバーをすぐに実行するには、次のコマンドを実行します。

npx nrepl-mcp-server

手動インストール

1. リポジトリをクローン します。
2. 依存関係をインストール します。

   npm install
   

3. プロジェクトをビルド します（TypeScript を JavaScript に変換）。

   npm run build
   

4. サーバーを起動 します。
   • 本番モード：コンパイルされた出力から実行します。

     npm start
     

   • 開発モード：ts-node を使用してリアルタイムで変更を反映します。

     npm run dev
     

これにより、サーバーが起動し、標準入出力で MCP リクエストを待機します。MCP クライアントは自動的にサーバーを起動します。

💻 使用例

基本的な使用法

nREPL への接続

ホストとポートを指定して、nREPL サーバーに接続できます。

Clojure コードの評価

任意の Clojure 式を、デフォルトの名前空間 または 指定された名前空間 で実行できます。

名前空間情報の取得

tools.namespace を使用して、プロジェクトディレクトリ内のすべての名前空間を一覧表示できます。

公開変数の調査

指定された名前空間内のすべての 公開変数 のメタデータと現在の値を取得できます。

nREPL 接続状態の取得

現在の nREPL 接続に関する詳細情報（ホスト、ポート、セッション ID、最後のエラー（ある場合））を取得できます。

📚 ドキュメント

リソース

nrepl://status

現在の nREPL 接続に関する情報を提供します。

• ホストとポート
• 接続状態
• アクティブなセッション ID

nrepl://namespaces

プロジェクトディレクトリ内で検出されたすべての名前空間を一覧表示します。

🤝 貢献

貢献を歓迎します！機能提案やバグ報告がある場合は、イシューを作成するか、プルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。このライセンスの条項に従って、自由に変更および配布することができます。