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，共同完善本項目。