Project Handoffs

🚀 项目交接 MCP 服务器

本 MCP 服务器用于管理 AI 会话交接和后续跟踪，能有效提升工作流程的组织性与效率。

🚀 快速开始

本 MCP 服务器可助力管理 AI 会话交接与后续跟踪。您可借助提供的工具创建项目、管理步骤及记录交接详情。

✨ 主要特性

• 核心概念清晰：以“NextStep → 工作会话 → 交接 → 新 NextStep 链接”为流程，基于项目进行组织，明确优先级与实现影响的映射关系。
• 丰富工具支持：提供一系列工具用于管理项目、下一步、工作会话和交接，如列出模板、创建和删除项目、开始工作会话等。
• 完善的错误处理：通过 ProjectError 类实现错误处理，确保系统稳定性。
• 模板验证与状态管理：对所有实体类型进行模板验证，实现一致的状态管理。
• 安全的数据持久化：采用带有适当错误处理的安全数据持久化机制。
• 类型安全实现：遵循项目内存服务器模式，实现类型安全。

📦 安装指南

安装依赖

npm install
npm run build

配置

将以下内容添加到您的 MCP 配置中：

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

💻 使用示例

可用工具

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

📚 详细文档

项目结构

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 类实现错误处理，确保系统在出现异常时能提供清晰的错误信息。
• 模板验证：对所有实体类型的模板进行验证，保证数据的一致性和完整性。
• 状态管理：采用一致的状态管理机制，便于跟踪和管理项目的各个阶段。
• 数据持久化：实现安全的数据持久化，带有适当的错误处理，确保数据的可靠性。
• 类型安全：遵循项目内存服务器模式，实现类型安全的代码，提高代码的可维护性。

📄 许可证

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

⚠️ 重要提示

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

💡 使用建议

欢迎贡献。请随意提交 Pull Request，共同完善本项目。