Project Handoffs MCP Server

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

核心概念

• 下一步 → 工作会话 → 交接 → 新的下一步链
• 基于项目的组织
• 优先级级别映射到实现影响：
  • 核心关键：对工作实现至关重要
  • 完整必需：对于期望的实现是必要的
  • 改进：改进和优化

可用工具

• 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类进行错误处理
• 对所有实体类型的模板进行验证
• 一致的状态管理
• 使用适当的错误处理安全地持久化数据
• 遵循project-memory-server模式的类型安全实现

安全

如果您发现了一个安全漏洞，请创建一个带有标签'security'的新问题。我们非常重视所有的安全报告，并将迅速响应。

贡献

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

许可证

本项目根据Apache许可证2.0版授权 - 详情见LICENSE文件。 </中文翻译>