Modex

🚀 Modex 介紹

Modex 是一個採用 Clojure 實現的 MCP（模型上下文協議）客戶端和服務器，基本遵循 2024 - 11 - 05 MCP 規範。消息採用 JSON - RPC 2.0 的序列化格式。

✨ 主要特性

• 通信協議：支持兩種傳輸類型：

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

• 主要組件：

  • MCP 客戶端：藉助 stdio 與 MCP 服務器進行交互。
  • MCP 服務器：實現 AServer 協議，支持工具、資源和提示。

🚀 快速開始

構建 Modex

lein project

運行 MCP 服務器

clojure -m modex.mcp.server

配置 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": ""
}

重啟 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!"
}

🔧 技術細節

核心組件

• Modex 服務器

  • 實現 AServer 協議
  • 支持工具、資源和提示

• MCP 客戶端（如 Claude Desktop）

  • 使用標準輸入輸出與 MCP 服務器交互

工具實現

• 工具

  • 使用 defmodex 定義工具
  • 處理方法使用 handle-tool-call

• 消息格式

  • 請求：{:keys [id method ?params]}
  • 響應：{:keys [id result ?error]}
  • 通知：{:keys [method ?params]}

📈 項目狀態

• [x] 測試通過
• [x] 易用性（AServer/A Client 協議）
• [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 - 當前維護者

感謝您的關注！