MCP Codex

🚀 MCP - Codex項目文檔

MCP - Codex 是一個用於協調模型上下文協議（Model Context Protocol, MCP）服務器的服務。它能讓 AI 助手動態發現並使用工具，無需重啟服務。核心“圖書管理員”智能代理，可理解並連接用戶需求與合適工具，解決傳統 MCP 實現的諸多侷限。

🚀 快速開始

啟動 Codex 服務

python codex - serv.py

啟動 MCP 客戶端

python mcp - codex.py

集成到 Claude Desktop

1. 安裝 MCP 客戶端：

   mcp install mcp - codex.py
   

2. 註冊兩個工具：
   • search：查找相關工具
   • call_tool：執行發現的工具

✨ 主要特性

解決傳統 MCP 實現的侷限性

傳統 MCP 實現存在靜態配置、本地運行、有限的發現機制和高認知負荷等問題。MCP - Codex 提供了對應的解決方案：

• 動態工具發現：AI 助手可根據需求自動發現並使用新工具。
• 標準化接口：統一的工具發現和執行接口。
• 遠程執行支持：工具可運行於任何位置。
• 中央化管理：提供單點控制以管理工具部署和更新。

項目架構優勢

核心組件

• Codex 服務：提供 REST API 接口用於工具搜索和調用，負責工具註冊、發現和執行。
• 圖書管理員 (The Librarian)：作為智能代理，負責複雜的工具選擇邏輯，維護行業知識庫和內部文檔數據庫。
• 工具倉庫：存儲所有可用工具及其元數據，支持工具版本控制和兼容性檢查。

項目規劃亮點

圖書管理員（詳細版）

• 作為代理 RAG 系統：結合檢索與生成智能。
• 維護多知識源：包括行業技術信息數據庫、內部工具文檔庫和即時 MCP 生態系統索引。
• 執行復雜工具選擇邏輯：分析用戶查詢以識別意圖，匹配所需功能，在整個 MCP 生態中查找最優工具，考慮工具兼容性、性能和可靠性。

項目意義顯著

• 實現真正代理功能：允許 AI 助手根據用戶需求動態發現和使用工具。
• 降低運營複雜性：無需重啟服務即可添加新能力。
• 集中化工具管理：提供單點控制用於工具部署和更新。
• 標準化工具交互：創建一致的接口用於工具發現和執行。
• 遠程執行支持：工具可運行於任何位置。

📚 詳細文檔

工具註冊配置

工具定義在 config/codex.yaml 文件中，結構如下：

tools:
  - name: tool_name
    description: 工具描述
    server: path/to/tool/server.py
    methods:
      - method_name
    schemas:
      method_name:
        type: object
        properties:
          # 參數定義

API 端點

• /health：健康檢查端點
• /search：搜索匹配工具
• /call_tool：執行特定工具方法
• /reload：重新加載工具配置

📄 許可證

項目使用 MIT 許可證，具體許可內容請參考 LICENSE 文件。