Claude Project Coordinator

🚀 Claude項目協調器

Claude項目協調器是一個基於MCP（模型上下文協議）的服務器，用於管理和協調多個Xcode/Swift項目。它提供了跟蹤項目狀態、搜索代碼模式以及維護開發見解知識庫等工具，能有效提升開發效率和項目管理的便捷性。

🚀 快速開始

關鍵更新提示

如果您使用的是v1.3.0及以上版本，且遇到項目創建日期顯示錯誤（所有項目均顯示為今天的日期）的問題，請運行以下命令：

./scripts/repair-analytics-dates.sh

此命令可修復一個在每次重啟時分析數據都會重新遷移的漏洞，該漏洞已在v1.3.2版本中修復。

✨ 主要特性

• 🚀 項目管理：跟蹤多個Xcode項目，記錄項目狀態、備註和元數據。
• 🔍 智能搜索：在多個項目和文檔中搜索代碼模式。
• 📚 知識庫：維護代碼模式、模板和故障排除指南。
• 🤖 自動檢測：自動檢測SwiftUI、UIKit、SPM等技術。
• 💾 持久存儲：所有數據以結構化的JSON格式本地存儲。
• 🔐 安全至上：提供全面的輸入驗證和路徑遍歷保護。
• 📊 項目分析（v1.3.0+）：支持時間跟蹤、活動熱力圖和健康評分。
• 📈 技術趨勢分析（v1.3.0+）：分析框架使用情況和採用模式。

🛡️ 安全特性（v1.2.0+）

• 🛡️ 輸入驗證：對所有用戶輸入進行全面驗證。
• 🚫 路徑遍歷保護：阻止類似../../../etc/passwd的惡意路徑。
• 📁 目錄訪問控制：可配置項目允許訪問的目錄。
• 🚨 注入預防：驗證搜索模式，防止命令注入。
• ⚖️ 合理限制：設置輸入長度限制，防止緩衝區溢出攻擊。
• 📝 清晰的錯誤信息：安全驗證失敗時提供有用的指導。
• ⚙️ 硬編碼安全策略：安全策略編譯到二進制文件中，確保可靠性。

📦 安裝指南

前提條件

• 安裝了Swift 5.9及以上版本的macOS系統。
• 安裝Claude桌面應用程序。

從源代碼構建

1. 克隆倉庫：

git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator

2. 構建項目：

swift build -c release

3. 記錄構建後可執行文件的路徑：

.build/release/project-coordinator

配置Claude桌面應用

1. 打開Claude桌面應用。
2. 導航至：設置 → 開發者 → 模型上下文協議。
3. 添加以下配置：

{
  "mcpServers": {
    "project-coordinator": {
      "command": "/path/to/Claude-Project-Coordinator/.build/release/project-coordinator",
      "args": []
    }
  }
}

4. 重啟Claude桌面應用。

💻 使用示例

基礎用法

配置完成後，您可以通過Claude與項目協調器進行交互：

• 列出項目：“Show me all my tracked projects”
• 添加項目：“Add my WeatherApp project at ~/Developer/WeatherApp”
• 更新狀態：“Update WeatherApp status to 'Implementing API integration'”
• 搜索代碼模式：“Find all SwiftUI patterns”
• 獲取項目詳情：“What's the status of my TodoApp?”

高級用法

分析命令（v1.3.0+）

• 時間跟蹤：“How long has Ubermania been in development?”
• 活動熱力圖：“Show me my project activity this week”
• 技術趨勢分析：“What technologies am I using most?”
• 健康檢查：“Which projects need my attention?”

📊 詳細輸出示例和實用提示請參考 ANALYTICS-EXAMPLES.md！

示例工作流

You: "Add my new SwiftUI project called FinanceTracker at ~/Developer/FinanceTracker"
Claude: "Successfully added project: FinanceTracker..."

You: "Update FinanceTracker status to 'Working on Core Data models'"
Claude: "Successfully updated FinanceTracker"

You: "Which of my projects use Core Data?"
Claude: [Shows all projects with Core Data in their tech stack or notes]

分析輸出示例

You: "Show my project activity this week"

Claude:
## Project Activity Heat Map (Past 7 Days)

🔥🔥🔥 **TodoApp** (15 activity points - 6 events)
🔥🔥 **WeatherStation** (8 activity points - 3 events)
🔥 **PortfolioSite** (3 activity points - 2 events)
💤 **OldBlogEngine** (0 activity points)

### Daily Activity Breakdown:
- Monday: 4 events
- Tuesday: 8 events
- Wednesday: 3 events

📚 詳細文檔

MCP工具列表

list_projects

列出所有跟蹤項目及其元數據。

add_project

添加一個新的項目進行跟蹤。

• 參數：name、path、description（可選）
• 安全機制：驗證項目名稱、路徑和描述。

get_project_status

獲取特定項目的詳細信息。

• 參數：projectName
• 安全機制：驗證項目名稱。

update_project_status

更新項目狀態和/或備註。

• 參數：projectName、status（可選）、notes（可選）
• 安全機制：驗證所有文本輸入。

search_code_patterns

在項目和知識庫中搜索代碼模式。

• 參數：pattern
• 安全機制：驗證搜索模式，防止注入攻擊。

項目結構

Claude-Project-Coordinator/
├── Sources/
│   └── ProjectCoordinator/
│       ├── main.swift              # 入口點
│       ├── MCPServer.swift         # MCP協議實現
│       ├── ProjectManager.swift    # 項目管理邏輯
│       └── SecurityValidator.swift # 輸入驗證和安全配置
├── KnowledgeBase/
│   ├── projects/                  # 項目數據存儲
│   ├── patterns/                  # 代碼模式
│   ├── templates/                 # 項目模板
│   └── tools/                     # 開發工具/指南
├── scripts/
│   └── build.sh                   # 構建腳本
├── Package.swift                  # Swift包清單
├── CHANGELOG.md                   # 版本歷史
└── README.md                      # 本文件

知識庫

知識庫預先填充了以下內容：

• SwiftUI模式和最佳實踐
• Xcode鍵盤快捷鍵
• 故障排除指南
• 項目模板

您可以通過在相應目錄中創建Markdown文件來添加自己的內容。

項目分析（v1.3.0+）

分析系統在後臺自動運行，跟蹤以下信息：

• 時間跟蹤：自動跟蹤每個項目狀態下花費的時間，無需手動設置計時器，只需正常更新狀態即可。使用get_project_timeline查看完整時間線。
• 活動監控：記錄所有交互，包括狀態更改、備註和搜索，生成項目活動水平熱力圖，幫助您識別最活躍和最不活躍的項目。
• 技術分析：跟蹤所有項目中框架和工具的使用情況，識別您正在嘗試的新興技術，並展示隨時間的採用趨勢。
• 健康評分：對項目健康狀況進行多因素分析（0 - 100分），考慮因素包括活動水平、陳舊度、文檔完整性和任務完成情況，並提供可操作的改進建議。

注意：分析結果以格式化文本形式顯示在Claude聊天中，優化了可讀性和快速洞察。詳細輸出示例請參考 ANALYTICS-EXAMPLES.md。

🔧 技術細節

• 使用Swift構建，無需外部依賴。
• 使用JSON-RPC進行MCP通信。
• 採用Async/await實現現代Swift併發。
• 基於Actor的架構確保線程安全。
• 提供全面的輸入驗證和安全加固。

📄 許可證

本項目採用MIT許可證，您可以自由在自己的項目中使用！

貢獻指南

歡迎為項目做出貢獻！您可以：

• 報告漏洞
• 提出新功能建議
• 提交拉取請求
• 完善文檔
• 分享您的代碼模式和模板

致謝

本項目是探索模型上下文協議（MCP）生態系統以增強AI輔助開發工作流的一部分。

Made with ❤️ from 🍍 Pineapple