模型上下文协议（MCP）服务器

用于管理开发环境和工作流程的模型上下文协议（MCP）服务器实现。

特性

• 基于Socket的传输，具有可靠的报文封装
• 完整支持JSON-RPC 2.0协议
• 具有功能协商能力的会话管理
• 可扩展的工具注册系统
• 项目、工作包和任务管理
• 检查点和恢复功能
• 支持质量保证审查工作流

初始设置

# 安装依赖
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编译（如果你更喜欢运行编译后的版本）
npm run watch

# 当使用监控模式时，在另一个终端中运行
npm start

清洁启动

如果遇到任何问题，可以尝试进行清洁构建：

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

# 重新安装依赖
npm ci

# 重新构建项目
npm run build

# 在开发模式下启动
npm run dev

架构

核心组件

1. 报文封装

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

2. 传输层

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

3. 会话管理

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

4. 工具注册表

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

工具

1. 项目管理

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

2. 工作包管理

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

3. 任务管理

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

4. 质量保证工具

   • 审查工作流
   • 修复请求
   • 工作包接受

配置

环境变量：

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

协议

服务器实现了基于JSON-RPC 2.0的模型上下文协议：

interface MCPMessage {
  jsonrpc: "2.0";
  id: number;
  method?: string;      // 对于请求
  params?: any;         // 对于请求
  result?: any;         // 对于响应
  error?: {             // 对于错误响应
    code: number;
    message: string;
    data?: any;
  };
}

报文流程

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

开发

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

贡献

1. 分叉仓库
2. 创建你的功能分支
3. 提交更改
4. 推送到分支
5. 创建拉取请求

许可证

ISC许可证