项目交接 MCP 服务器

用于管理 AI 会话交接和下一步跟踪的 MCP 服务器。

核心概念

• NextStep → 工作会话 → 交接 → 新 NextStep 链接
• 基于项目的组织方式
• 优先级与实现影响映射：
  • core-critical: 对工作中的实现至关重要
  • full-required: 实现所需功能的必要条件
  • enhancement: 改进和优化

可用工具

• list_templates - 列出可用的下一步、工作会话和交接模板
• create_project - 创建一个新的项目以跟踪 AI 会话交接
• delete_project - 删除一个项目及其所有数据
• create_next_step - 在项目中创建新的下一步
• start_working_session - 开始处理下一步
• create_handoff - 完成工作会话并记录交接细节
• get_latest_next_steps - 获取按优先级排序的开放下一步
• get_next_step_history - 获取某一步骤的完整历史，包括会话和交接

安装

npm install
npm run build

配置

添加到您的 MCP 配置中：

{
  "mcpServers": {
    "project-handoffs": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/project-handoffs/build/index.js"],
      "alwaysAllow": []
    }
  }
}

项目结构

project-handoffs/
├── src/
│   ├── index.ts           # 主程序文件
│   ├── templates.ts       # 实体模板
│   ├── types.ts          # TypeScript 类型
│   └── errors.ts         # 错误处理
├── package.json          
└── README.md

开发

# 安装依赖项
npm install

# 开发模式
npm run dev

# 构建
npm run build

实现细节

• 通过 ProjectError 类实现错误处理
• 所有实体类型的模板验证
• 一致的状态管理
• 带有适当错误处理的安全数据持久化
• 遵循项目内存服务器模式的类型安全实现

安全性

如果您发现任何安全漏洞，请创建一个带有 'security' 标签的新问题。我们认真对待所有安全报告并会及时响应。

贡献

欢迎贡献。请随意提交 Pull Request。

许可证

本项目根据 Apache License 2.0 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。