克劳德项目协调器

Name: 克劳德项目协调器
Author: M-Pineapple

作者：M-Pineapple41 星标更新：2025-07-04

安装使用来源：spider==github.com

项目介绍

🚨 v1.3.0+ 用户重要更新

如果你遇到项目创建日期不正确（所有日期都显示为今天的日期），请运行：

./scripts/repair-analytics-dates.sh

这将修复一个错误，该错误导致每次重启时都会重新迁移分析数据。已在 v1.3.2 版本中修复。

Claude 项目协调器

这是一个用于管理和协调多个 Xcode/Swift 项目的 MCP（模型上下文协议）服务器。此服务器提供了跟踪项目状态、搜索代码模式以及维护开发见解知识库的工具。

功能

🚀 项目管理：跟踪多个 Xcode 项目及其状态、备注和元数据
🔍 智能搜索：跨项目和文档搜索代码模式
📚 知识库：维护模式、模板和故障排除指南
🤖 自动检测：自动检测 SwiftUI、UIKit、SPM 等技术
💾 持久存储：所有数据以结构化的 JSON 格式本地存储
🔐 安全第一：全面的输入验证和路径遍历保护
📊 项目分析：时间跟踪、活动热图和健康评分（v1.3.0+）
📈 技术趋势：分析框架使用和采用模式（v1.3.0+）

安全功能（v1.2.0+）

🛡️ 输入验证：对所有用户输入进行全面验证
🚫 路径遍历保护：阻止恶意路径如 ../../../etc/passwd
📁 目录访问控制：配置允许的项目目录
🚨 注入预防：验证搜索模式以防止命令注入
⚖️ 合理限制：输入长度限制以防止缓冲区溢出攻击
📝 清晰的错误消息：当安全验证失败时提供有用的指导
⚙️ 硬编码安全：将安全策略编译到二进制文件中以确保可靠性

安装

先决条件

macOS 和 Swift 5.9+
Claude 桌面应用

从源码构建

克隆仓库：

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

构建项目：

swift build -c release

记住构建可执行文件的路径：

.build/release/project-coordinator

配置 Claude 桌面

打开 Claude 桌面
导航至：设置 → 开发者 → 模型上下文协议
添加配置：

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

重启 Claude 桌面

使用方法

配置完成后，你可以通过 Claude 与项目协调器进行交互：

基本命令

列出项目："展示我所有的跟踪项目"
添加项目："添加我的 WeatherApp 项目在 ~/Developer/WeatherApp"
更新状态："更新 WeatherApp 状态为 '实现 API 集成'"
搜索模式："查找所有 SwiftUI 模式"
获取项目详情："我的 TodoApp 的状态是什么？"

分析命令（v1.3.0+）

时间跟踪："Ubermania 已经开发了多久？"
活动热图："展示我本周的项目活动"
技术趋势："我最常用的技术是什么？"
健康检查："哪些项目需要我的关注？"

📊 参见 ANALYTICS-EXAMPLES.md 获取详细的输出示例和有效提示！

示例工作流程

你："添加我在 ~/Developer/FinanceTracker 的新 SwiftUI 项目 FinanceTracker"
Claude："成功添加项目：FinanceTracker..."

你："更新 FinanceTracker 状态为 '正在构建 CoreData 模型'"
Claude："成功更新 FinanceTracker"

你："我的哪些项目使用了 CoreData？"
Claude：[显示所有包含 CoreData 技术栈或备注中的项目]

分析输出示例

你："展示我本周的项目活动"

Claude：
## 项目活动热图（过去 7 天）

🔥🔥🔥 **TodoApp** (15 活动点数 - 6 事件)
🔥🔥 **WeatherStation** (8 活动点数 - 3 事件)
🔥 **PortfolioSite** (3 活动点数 - 2 事件)
💤 **OldBlogEngine** (0 活动点数)

### 每日活动分解：
- 星期一：4 事件
- 星期二：8 事件
- 星期三：3 事件

安全配置

安全设置是为可靠性和安全性而硬编码在 Swift 源代码中。默认配置包括：

默认安全设置

允许的项目目录：

~/Developer
~/Documents
~/GitHub
~/Projects
~/Desktop/Development
~/Xcode

输入限制：

项目名称：最大 100 字符
项目路径：最大 500 字符
描述：最大 2,000 字符
备注：最大 10,000 字符
搜索模式：最大 300 字符

自定义安全设置

要修改安全设置：

编辑源代码：打开 Sources/ProjectCoordinator/SecurityValidator.swift

修改配置值：

// 增加/删除允许的基础路径
static let allowedBasePaths = [
    NSHomeDirectory() + "/Developer",
    NSHomeDirectory() + "/Documents", 
    NSHomeDirectory() + "/GitHub",
    NSHomeDirectory() + "/Projects",
    NSHomeDirectory() + "/Desktop/Development",
    NSHomeDirectory() + "/Xcode"
    // 在这里添加你的自定义路径
]

// 调整长度限制
static let maxProjectNameLength = 100
static let maxDescriptionLength = 2000
static let maxNotesLength = 10000
static let maxSearchPatternLength = 300

重新构建项目：
```
swift build -c release
```
重启 Claude 桌面 使用更新后的二进制文件

为什么是硬编码配置？

安全性：配置无法在运行时被篡改
可靠性：没有配置文件损坏或篡改的风险
简单性：无需额外的文件管理和解析复杂性
性能：设置已编译，没有运行时解析开销

可用的 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 获取真实输出示例。

💖 支持这个项目

如果 CPC 帮助简化了你的开发工作流程或节省了管理项目的宝贵时间，请考虑支持其开发：

你的支持帮助我：

维护和改进 CPC 新特性
保持项目开源且免费供所有人使用
更多地投入时间解决用户请求和修复错误
探索增强开发生产力的新工具

感谢您考虑支持我的工作！🙏

工作原理

项目协调器：

使用 MCP 协议通过标准 I/O 与 Claude 桌面通信
通过全面的安全系统验证所有输入
将项目数据存储为 KnowledgeBase/projects/ 中的 JSON 文件
将分析数据存储在 KnowledgeBase/analytics/
通过扫描项目目录自动检测技术
维护索引以实现快速搜索和检索
跟踪所有项目交互以进行分析

安全注意事项

对于个人开发者：

默认安全设置设计用于个人开发工作流
在保持易用性的同时防范常见攻击向量
安全设置可以通过修改源代码并重新构建来定制

对于组织：

组织应评估自身的安全需求
生产环境可能需要额外的安全措施
考虑实施额外的身份验证和审计日志记录以供共享使用
硬编码配置防止运行时篡改

示例文件及文档

ANALYTICS-EXAMPLES.md - 真实输出示例和有效提示
CHANGELOG.md - 详细版本历史
安全功能 - 见上文的安全配置部分

贡献

欢迎贡献！请随意：

报告错误
建议新功能
提交拉取请求
改进文档
分享你的模式和模板

技术细节

使用 Swift 编写，无外部依赖
使用 JSON-RPC 进行 MCP 通信
使用异步/等待进行现代 Swift 并发
使用基于 actor 的架构保证线程安全
全面的输入验证和安全加固

许可证

MIT 许可证 - 欢迎在你自己的项目中使用！

更新日志

参见 CHANGELOG.md 获取详细版本历史和安全改进。

致谢

作为探索模型上下文协议（MCP）生态系统以增强 AI 辅助开发工作流的一部分而构建。

由 🍍 Pineapple 制作，充满 ❤️