Claude Project Coordinator

CPC 是一个 MCP 服务，为 Claude 提供结构化的磁盘上项目视图：状态、笔记、技术栈、活动和健康状况。它运行在 macOS 上，与 Claude Desktop、Cursor 或 Claude Code 并行。数据不会离开你的设备。

v1.4.2 · 官方 Swift MCP SDK · MIT · 本地 JSON 知识库

---

快速开始

需要 macOS 13+、Swift 6.0+（Xcode 16+）和 MCP 主机（Claude Desktop、Cursor 或 Claude Code）。

1. 构建：

   git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
   cd Claude-Project-Coordinator
   swift build -c release
   

2. 使用二进制文件的绝对路径，将服务添加到 MCP 主机配置中：

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

3. 重启主机并询问：“添加我的 WeatherApp，路径是 ~/Developer/WeatherApp”，然后再问：“哪些项目需要我关注？”

项目必须位于允许的根目录之一。完整详情请参阅安装。

---

适合哪些人？

选择符合你情况的使用方式。相同的二进制文件，不同的第一个问题。

1. 管理多个项目的 Swift 爱好者

你有好几个应用和软件包。频繁切换上下文很费时间，而且你会忘记哪个代码仓库正在进行重构。

从这里开始：

• “添加我的 WeatherApp，路径是 ~/Developer/WeatherApp”
• “显示我跟踪的所有项目”
• “哪些项目需要我关注？”
• “将 WeatherApp 的状态更新为‘Core Data 模型完成了一半’”

你将获得： 一个持续更新的项目列表，其中包含状态、笔记、自动检测的技术（SwiftUI、SPM、Xcode 项目/工作区）和健康评分，让沉寂的项目重新进入视野。

2. Claude Desktop 日常用户

Claude 是你的编码工作台。你希望在不同聊天之间保持连贯，不必反复粘贴相同的项目列表。

从这里开始：

• “列出我的项目及其当前状态”
• “TodoApp 怎么样了？”
• “找出我们存储的所有 SwiftUI 模式”
• “显示我本周的项目活动”

你将获得： Claude 可以调用九个 MCP 工具查询你的知识库，而不必根据对话记忆猜测。

3. Cursor 或 Claude Code Agent 用户

Agent 擅长编写代码，却容易失去全局视角。你希望 Agent 知道自己正在处理哪个项目，以及该项目的健康状况如何。

从这里开始：

• 在 Cursor / Claude Code MCP 设置中接入 CPC（参见安装）
• “获取 Claude-Project-Coordinator 的项目状态”
• “获取我跟踪项目的技术趋势”
• “显示 14 天活动热力图”

你将获得： 项目健康状况和时间线会作为工具结果提供给 Agent，以便它据此采取行动，并与它已能看到的文件并列呈现。

4. 注重隐私 / 仅限本地的设置

你不会把项目清单发送到云端项目管理工具。所有内容都应保存在二进制文件旁边。

从这里开始：

• 从源代码构建，并将 MCP 指向 .build/release/project-coordinator
• 可选：使用 CPC_KNOWLEDGE_BASE=~/Library/Application Support/CPC 将数据存放在 git 目录之外
• 不要将 KnowledgeBase/projects/*.json 放入公开代码仓库（已加入 gitignore）

你将获得： 磁盘上的 JSON、路径允许列表、无需账户、不收集遥测数据。

5. 已在使用 Memory MCP

你已在 Memory Service（或类似服务）中存储决策和人员信息，不想再存一份对话记录。

它们如何配合：

	CPC	Memory MCP
用途	项目资料和状态	对话上下文和决策
形式	结构化工具 + JSON 文件	笔记、标签、搜索
询问	“哪些项目已过时？”	“我们对入职流程做了什么决定？”

两者都使用，不要用其中一个取代另一个。

---

完整功能列表

项目管理台

功能	详情
跟踪多个项目	名称、路径、描述、状态、笔记、当前任务、最后修改时间
从路径添加	验证路径、扫描文件夹、存储 JSON 记录
更新状态 / 笔记	无需单独的应用即可保持管理台信息最新
列出所有项目	一条提示词 → 完整项目清单及技术栈
深入查看单个项目	状态、笔记、任务、路径、检测到的技术

自动检测

添加项目时，CPC 会检查文件夹并为检测到的内容添加标签：

• Swift Package Manager（Package.swift）
• Xcode 项目（.xcodeproj）
• Xcode 工作区（.xcworkspace）
• SwiftUI（扫描到的 Swift 文件中包含 import SwiftUI）
• 如果没有其他匹配项，则回退到 Swift

搜索和知识库

功能	详情
模式搜索	搜索已跟踪项目和 KnowledgeBase Markdown 文件
内置指南	Swift 模式、SwiftUI 实践、Xcode 快捷键、故障排除
模板	KnowledgeBase/templates/ 下的入门文档
自有文档	将 Markdown 文件放入 patterns/、tools/ 或 templates/，即可通过搜索找到

分析（自动）

无需单独的计时应用。状态更新和工具使用情况会在后台生成分析数据。

工具	可回答的问题
get_project_timeline	此项目处于各状态多久了？项目有多旧？
get_activity_heatmap	过去 N 天里哪些项目最活跃？
get_technology_trends	哪些框架占主导？有哪些新兴趋势？
get_project_health	0–100 分的评分及建议（活动、新鲜度、文档、任务）

聊天输出示例：ANALYTICS-EXAMPLES.md。

安全与存储

功能	详情
本地 JSON	Mac 上的 KnowledgeBase/projects/ 和分析文件
路径允许列表	仅允许位于已配置根目录下的路径（默认：Developer、Documents、GitHub、Projects 等）
输入限制	限制名称、路径、笔记和搜索内容的长度
注入检查	筛查搜索模式，阻止类似 shell 的载荷
环境变量覆盖	使用 CPC_KNOWLEDGE_BASE 指定自定义数据目录
Stdio 安全日志	诊断信息仅写入 stderr（MCP 主机独占 stdout）

---

所有 MCP 工具

工具	参数	用途
list_projects	—	列出所有已跟踪项目
add_project	name、path、可选的 description	注册项目并自动检测技术
get_project_status	projectName	查看单个项目的完整详情
update_project_status	projectName、可选的 status、notes	更新管理台条目
search_code_patterns	pattern	搜索项目和知识库
get_project_timeline	projectName	状态历史和持续时间
get_activity_heatmap	可选的 days（默认值为 7）	活动热力图
get_technology_trends	—	查看项目组合中的框架使用情况
get_project_health	—	健康评分和建议

你可以使用自然语言交流。主机会将你的表达映射到这些工具。

---

示例工作流

You: Add my new SwiftUI project FinanceTracker at ~/Developer/FinanceTracker
Claude: Successfully added… Detected tech stack: Swift Package Manager, SwiftUI

You: Update FinanceTracker status to 'Working on Core Data models'
Claude: Updated.

You: Which of my projects use Core Data or SwiftUI?
Claude: [search + roster]

You: Which projects need my attention?
Claude: [health report with scores and recommendations]

You: Show my activity this week
Claude: [heat map]

---

前置条件

• macOS 13+
• Swift 6.0+（Xcode 16+）
• MCP 主机：Claude Desktop、Cursor 或 Claude Code

安装

从源代码构建

git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator
swift build -c release

可执行文件：

.build/release/project-coordinator

Claude Desktop

设置 → 开发者 → Model Context Protocol：

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

Cursor

将相同的服务条目添加到 Cursor MCP 设置 JSON 中，并使用 .build/release/project-coordinator 的绝对路径。

Claude Code

在 Claude Code 的 MCP 配置中注册相同的 command 路径。

可选：将 CPC_KNOWLEDGE_BASE 设置为自定义 KnowledgeBase 目录（如果克隆仓库是公开的，而你希望项目 JSON 保持私密，这会很有用）。

更改配置后，重启宿主。

---

安全配置

默认值位于 Sources/ProjectCoordinator/SecurityValidator.swift 中（编译时内置）。

允许的根目录： ~/Developer、~/Documents、~/GitHub、~/Projects、~/Desktop/Development、~/Xcode

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

如需更改允许列表或限制，请编辑源代码，重新构建（swift build -c release），然后重启宿主。

---

项目结构

Claude-Project-Coordinator/
├── Sources/
│   ├── ProjectCoordinator/     # Library (MCP, manager, analytics, security)
│   └── project-coordinator/    # Executable entry point
├── Tests/ProjectCoordinatorTests/
├── KnowledgeBase/              # Patterns, templates, local project/analytics data
├── scripts/                    # Build and repair helpers
├── ANALYTICS-EXAMPLES.md       # Sample analytics output
├── Package.swift
└── README.md

---

从 v1.3.x 升级

1. 执行 git pull 并使用 Swift 6 重新构建：swift build -c release
2. 将 MCP 宿主指向新的二进制文件
3. 如果创建日期被旧的重新迁移 Bug 破坏：

./scripts/repair-analytics-dates.sh

---

M-Pineapple 的更多 MCP 服务

此系列中的其他 MCP 服务：

• CryptoAnalysisMCP。为 Claude Desktop 提供加密货币技术分析。
• Warp Command Runner。为任意聊天 AI 提供真实终端。
• Msty Admin MCP。管理 Msty Studio Desktop。
• Member Berries。带有个性的 Apple Calendar、Notes 和 Reminders。
• SeaShell。在任意终端区块中与 Claude 对话。
• TextEdit MCP。通过 macOS TextEdit 创建格式化的 RTF 文档。
• HubSpot Auditor。只读审计 HubSpot 门户。

---

💖 支持此项目

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

你的支持能帮助我：

• 维护并通过新功能改进 CPC
• 让项目保持开源，并免费供所有人使用
• 投入更多时间处理用户请求和 Bug 修复
• 探索能提升开发者工作效率的新工具

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

---

贡献

欢迎贡献。你可以报告 Bug、建议新功能、提交拉取请求，或在 KnowledgeBase/ 下分享模式和模板。

许可证

MIT License。

致谢

为 MCP 生态系统打造。协议栈：modelcontextprotocol/swift-sdk。

---

来自 🍍 Pineapple，满怀 ❤️ 制作