Modex

🚀 Modex 紹介

Modex は、Clojure で実装された MCP（モデルコンテキストプロトコル）のクライアントとサーバーです。ほとんどの部分が 2024-11-05 MCP 仕様に準拠しています。メッセージは JSON-RPC 2.0 のシリアライズ形式を使用しています。

✨ 主な機能

• 通信プロトコル：2 種類の伝送タイプをサポートしています。

  • [x] 標準入出力（stdio/stdout）
  • [ ] Server-Sent Events (SSE)

• 主要コンポーネント：

  • MCP クライアント：stdio を通じて MCP サーバーとやり取りします。
  • MCP サーバー：AServer プロトコルを実装し、ツール、リソース、およびプロンプトをサポートします。

🚀 クイックスタート

1. Modex の構築

lein project

2. MCP サーバーの起動

clojure -m modex.mcp.server

3. Claude Desktop の設定

claude_desktop_config.json を開き、以下の内容を追加します。

{
  "mcpServers": {
    "modex": {
      "command": "java",
      "args": ["-jar", "/Users/your-username/code/modex/target/modex-mcp-0.2.2.jar"]
    }
  },
  "globalShortcut": ""
}

4. Claude Desktop の再起動

再起動後、run foo または what does foo say? を使用してツールを呼び出すことができます。

💻 使用例

基本的な使用法

(defmodex :foo
  (defmethod handle-tool-call :default
    [tool-id args]
    {:result "Hello, AI!"}))

高度な使用法

run foo または what does foo say? を呼び出すと、Claude Desktop は以下の JSON-RPC リクエストを送信します。

{
  "id": 1,
  "method": "tool/default",
  "params": {
    "toolId": ":foo"
  }
}

サーバーからの応答は以下の通りです。

{
  "id": 1,
  "result": "Hello, AI!"
}

🔧 技術詳細

ツール

• defmodex を使用してツールを定義します。
• 処理メソッドには handle-tool-call を使用します。

メッセージ形式

• リクエスト：{:keys [id method ?params]}
• レスポンス：{:keys [id result ?error]}
• 通知：{:keys [method ?params]}

📊 プロジェクトの状態

• [x] テスト合格
• [x] 使いやすさ（AServer/A クライアントプロトコル）
• [x] ツールサポート
• [ ] リソースサポート
• [ ] プロンプトサポート
• [進行中] SSE サポート
• [進行中] ストリーミング HTTP サポート（2025-03-26 MCP 仕様）

📖 開発背景

既存のライブラリ mcp-clj は SSE を使用しているため、mcp-proxy を使用して SSE <=> stdio を代理する必要があります。Modex はこのプロセスを簡素化することを目的としています。

❓ よくある質問

接続された MCP クライアント（Claude Desktop など）でサーバーを変更するにはどうすればいいですか？

現在は直接変更することはできませんが、nREPL サポートを追加する予定で、サービスを停止せずにコードの変更をリアルタイムに評価できるようになります。現時点では制限があるため、uberjar を再構築して Claude Desktop を再起動する必要があります。

🙏 謝辞

Modex の開発は、以下の有料顧客からの資金提供によって可能になりました。

• Nextdoc - ドキュメントストリームサービスを提供する Salesforce ツール
• Huppi - 中小企業向けの会計ソフトウェア

📄 ライセンス

• 非商用利用は無料：GPLv3 に基づいて使用、変更、および配布できますが、オープンソースを維持する必要があります。
• 商用利用：変更内容を非公開で使用したいユーザーは、$20 を一度支払うことで永久的な商用ライセンスを購入できます。これには、公開開発に使用した AI コンピュータートークンの費用が含まれています。

このツールは GNU General Public License v3.0 (GPLv3) に基づいて配布されています。あなたは自由に使用、変更、および配布する権利がありますが、ライセンスの条項に従う必要があります。

👨‍💻 作者

• Alex Petrov - 初期バージョン
• Andrey Vasilyev - 現在のメンテナー

ご関心いただき、ありがとうございます！