项目交接 MCP 服务器

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

核心概念

• 下一步骤 → 工作会话 → 交接 → 新的下一步骤链
• 基于项目的组织
• 优先级映射到实施影响：
  • 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 类进行错误处理
• 所有实体类型的模板验证
• 一致的状态管理
• 通过适当的错误处理实现安全的数据持久性
• 遵循 project-memory-server 模式的类型安全实现

安全

如果您发现安全漏洞，请创建一个带有标签“security”的新 issue。 我们会认真对待所有安全报告并及时回复。

贡献

欢迎贡献。 随时提交 Pull Request。

许可

本项目采用 Apache License 2.0 许可 - 有关详细信息，请参阅 LICENSE 文件。