🚀 项目交接 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，共同完善本项目。