🚀 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 文件。