MCP Codex

🚀 MCP - Codex 项目文档

MCP - Codex 是一个用于协调模型上下文协议 (Model Context Protocol, MCP) 服务器的服务，它能让 AI 助手动态发现和使用工具，无需重启服务。其核心“图书管理员”智能代理，可理解并连接用户需求与合适的工具。

🚀 快速开始

启动 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 提供了以下解决方案：

1. 动态工具发现：AI 助手可根据需求自动发现并使用新工具。
2. 标准化接口：统一的工具发现和执行接口。
3. 远程执行支持：工具可运行于任何位置。
4. 中央化管理：提供单点控制以管理工具部署和更新。

项目带来的重要意义

1. 实现真正代理功能：允许 AI 助手根据用户需求动态发现和使用工具。
2. 降低运营复杂性：无需重启服务即可添加新能力。
3. 集中化工具管理：提供单点控制用于工具部署和更新。
4. 标准化工具交互：创建一致的接口用于工具发现和执行。
5. 远程执行支持：工具可运行于任何位置。

📦 安装指南

本项目的安装主要是启动相关服务和客户端，具体命令如下：

启动 Codex 服务

python codex - serv.py

启动 MCP 客户端

python mcp - codex.py

集成到 Claude Desktop

1. 安装 MCP 客户端：

mcp install mcp - codex.py

2. 注册两个工具：
   • search：查找相关工具
   • call_tool：执行发现的工具

💻 使用示例

基础用法

启动 Codex 服务和 MCP 客户端：

# 启动 Codex 服务
python codex - serv.py
# 启动 MCP 客户端
python mcp - codex.py

高级用法

将项目集成到 Claude Desktop：

# 安装 MCP 客户端
mcp install mcp - codex.py
# 注册工具
# 注册 search 工具用于查找相关工具
# 注册 call_tool 工具用于执行发现的工具

📚 详细文档

项目架构

核心组件

1. Codex 服务
   • 提供 REST API 接口用于工具搜索和调用。
   • 负责工具注册、发现和执行。
2. 图书管理员 (The Librarian)
   • 智能代理，负责复杂的工具选择逻辑。
   • 维护行业知识库和内部文档数据库。
3. 工具仓库
   • 存储所有可用工具及其元数据。
   • 支持工具版本控制和兼容性检查。

项目规划（Roadmap）

图书管理员（详细版）

• 作为代理 RAG 系统：结合检索与生成智能。
• 维护多知识源：
  • 行业技术信息数据库
  • 内部工具文档库
  • 实时 MCP 生态系统索引
• 执行复杂工具选择逻辑：
  • 分析用户查询以识别意图
  • 匹配所需功能
  • 在整个 MCP 生态中查找最优工具
  • 考虑工具兼容性、性能和可靠性

文档资料

工具注册配置

工具定义在 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 文件。