Context Manager MCP 服务器

一个用于管理开发上下文和工作流程的模型上下文协议 (MCP) 服务器实现。

功能特性

• 基于 Socket 的传输，具有可靠的消息帧处理
• 完整的 JSON-RPC 2.0 协议支持
• 具有能力协商的会话管理
• 可扩展的工具注册系统
• 项目、工作包和任务管理
• 检查点和恢复功能
• QA 审查工作流程支持

初始设置

# 安装依赖
npm install

# 首次构建
npm run build

使用方法

启动服务器

# 开发模式（无需构建，使用 tsx 进行即时编译）
npm run dev

# 生产模式（需要构建）
npm start

# 以调试日志启动
DEBUG=1 npm run dev

# 在特定端口启动
MCP_PORT=44558 npm run dev

开发模式

# 运行热重载（开发期间首选）
npm run dev

# TypeScript 编译的 Watch 模式（如果您喜欢运行编译后的版本）
npm run watch

# 在使用 Watch 模式时，在单独的终端中运行
npm start

干净启动

如果遇到任何问题，您可以尝试干净构建：

# 移除构建产物
rm -rf dist/

# 重新安装依赖
npm ci

# 重新构建项目
npm run build

# 以开发模式启动
npm run dev

架构

核心组件

1. 消息帧处理

   • 基于 Content-Length 的协议
   • 可靠的消息边界处理
   • 缓冲区管理

2. 传输层

   • 基于 TCP Socket 的通信
   • 连接管理
   • 事件驱动架构

3. 会话管理

   • 客户端会话跟踪
   • 能力协商
   • 状态持久化

4. 工具注册

   • 动态工具注册
   • 输入验证
   • 结果格式化

工具

1. 项目管理

   • 创建/获取项目
   • 项目检查点
   • 状态恢复

2. 工作包管理

   • 创建/获取工作包
   • 进度跟踪
   • 状态更新

3. 任务管理

   • 创建/更新任务
   • 文件变更跟踪
   • 任务检查点

4. QA 工具

   • 审查工作流程
   • 修复请求
   • 工作包验收

配置

环境变量：

• DEBUG: 启用调试日志 (0/1)
• MCP_PORT: 服务器端口（默认：44557）

协议

服务器使用 JSON-RPC 2.0 实现了模型上下文协议：

interface MCPMessage {
  jsonrpc: "2.0";
  id: number;
  method?: string;      // for requests
  params?: any;         // for requests
  result?: any;         // for responses
  error?: {             // for error responses
    code: number;
    message: string;
    data?: any;
  };
}

消息流

1. 客户端通过 TCP 连接
2. 客户端发送初始化请求
3. 服务器响应能力
4. 正常的 message 交换开始
5. 客户端可以关闭/退出

开发

请参阅上面的 初始设置 和 开发模式 部分。

贡献

1. Fork 仓库
2. 创建您的特性分支
3. 提交您的更改
4. 推送到分支
5. 创建一个 Pull Request

许可证

ISC 许可证