oh-my-codex MCP 后端服务器集合
使用说明
- 项目简介
- 该仓库实现了一组基于 MCP（Model Context Protocol）的后端服务器，负责向 LLM 客户端提供统一的上下文服务能力，包括资源存取、工具调用、以及提示模板的渲染与交互。
- 具体服务器包括：状态管理服务器(state)、内存/记忆服务器(memory)、代码智能辅助服务器(code_intel)、追踪服务器(trace)以及团队执行相关的服务器(team)等。各服务器对外暴露 MCP 风格的工具集（如 state_read、state_write、notepad_read 等），并实现相应的请求处理逻辑。
- 主要功能点
- MCP 服务实现：为不同职责域提供独立的服务器实例，统一通过 MCP 协议暴露工具集（ListTools、CallTool），支持 JSON-RPC 风格的请求/响应。
- 资源与内存管理：提供 project memory、notepad、PROMPTS/AGENTS 的持久化、写入与读取能力，以及历史记录的维护。
- 工具注册与执行：提供工具集的注册、查询、执行与状态追踪，支持对工作流的分布式执行与协调。
- Prompts 与 Templates：支持 prompts 的加载、渲染与扩展，提供对 LLM 的上下文模板定制能力。
- STDIO 启动与自治：各 MCP 服务器通过共享的内置生命周期管理（bootstrap.ts）实现 STDIO 连接启动、信号处理与清理，便于以 MCP 客户端形式接入。
- 会话与作用域：通过 state 路径管理实现跨会话/全局的状态分区，支持 session-scoped 路径、工作目录约束等安全策略。
- 安装与运行要点
- 该仓库以 TypeScript/Node.js 实现，构建产物以 dist/mcp/*.js 为主入口，对应的入口也支持直接通过 Node 运行 dist/mcp/... 的文件。
- 运行时通常通过 bin/omx.js 或 dist/mcp/* 入口配合 STM/STDIO 模式启动，MCP 服务器将以“STDIO 服务端传输”方式接入，适配多种传输场景（如 STDIO）。
- 客户端使用 MCP 时需配置服务器启动命令与参数，本文给出在服务器端的配置示意，客户端只需要通过 MCP 客户端 API 与之通信即可。
- 服务器配置（MCP 客户端所需的配置示例说明）
注：以下为 MCP 服务器的启动配置示例描述，具体客户端使用不需要你直接修改客户端代码，仅需将此配置作为连接目标提供给 MCP 客户端即可。服务器配置示例如下（JSON 表达，供客户端参考）：
- omx_state 服务 { "server": "omx_state", "command": "node", "args": ["<dist 路径>/mcp/state-server.js"] // 启动选项可结合实际环境设置，例如 startup_timeout_sec 等 }
- omx_memory 服务 { "server": "omx_memory", "command": "node", "args": ["<dist 路径>/mcp/memory-server.js"] }
- omx_code_intel 服务 { "server": "omx_code_intel", "command": "node", "args": ["<dist 路径>/mcp/code-intel-server.js"] }
- omx_trace 服务 { "server": "omx_trace", "command": "node", "args": ["<dist 路径>/mcp/trace-server.js"] }
- omx_team_run 服务 { "server": "omx_team_run", "command": "node", "args": ["<dist 路径>/mcp/team-server.js"] } 说明
- 上述配置中的 dist 路径需指向实际构建产物中的对应 MCP 服务器文件（如 dist/mcp/state-server.js 等）。客户端在连接时无需执行这些服务器代码，只需指明服务器名称、启动命令及参数即可建立 MCP 连接。
- 也可以在 prod 环境中使用生成的配置输出（参考仓库的 config/generator.ts，自动生成包含 MCP 服务器条目的 config.toml）。
- 基本使用方法
- 构建与启动
- 安装依赖并构建：npm install，npm run build
- 以 STDIO 启动 MCP 服务器，依赖具体运行环境，通常通过 dist/mcp/... 的入口文件进行启动。
- 客户端接入
- 将上述服务器配置作为 MCP 服务端地址提供给客户端（JSON 对象，包含 server、command、args 等信息），客户端通过 MCP 框架与服务器建立连接，进行资源读取、工具调用、Prompt 渲染等交互。
- 运行与维护
- 服务器通过内置的 bootstrap.ts 自动接入 STDIO Life-cycle；支持信号处理、 graceful shutdown，确保高可用性。
- 构建与启动