Claude Project Coordinator

CPC は、プロジェクトのステータス、メモ、技術スタック、アクティビティ、健全性を構造化してディスク上で管理し、Claude に提供する MCP サーバーです。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. ホストを再起動し、「~/Developer/WeatherApp にある WeatherApp を追加して」と尋ねてから、「注意が必要なプロジェクトはどれ？」と尋ねます。

プロジェクトは許可されたルートのいずれかに配置する必要があります。詳細はインストールをご覧ください。

---

対象ユーザー

自分に合った使い方を選んでください。同じバイナリでも、最初に尋ねることは異なります。

1. 複数の Swift プロジェクトに取り組むホビイスト

複数のアプリやパッケージを持っています。コンテキストの切り替えに時間がかかり、どのリポジトリがリファクタリングの途中だったか忘れてしまいます。

まずは次のことから始めましょう：

• 「~/Developer/WeatherApp にある WeatherApp を追加して」
• 「追跡中のプロジェクトをすべて表示して」
• 「注意が必要なプロジェクトはどれ？」
• 「WeatherApp のステータスを『Core Data モデルは半分完了』に更新して」

得られるもの： ステータス、メモ、自動検出された技術（SwiftUI、SPM、Xcode のプロジェクト／ワークスペース）を含む最新のプロジェクト一覧と、しばらく動きのないプロジェクトを再び見つけやすくする健全性スコアです。

2. Claude Desktop を日常的に使うユーザー

Claude をコーディングデスクとして使っています。同じプロジェクト一覧を貼り付け直さずに、チャット間で文脈を引き継ぎたいと考えています。

まずは次のことから始めましょう：

• 「プロジェクトと現在のステータスを一覧表示して」
• 「TodoApp はどうなってる？」
• 「保存した SwiftUI のパターンをすべて探して」
• 「今週のプロジェクトアクティビティを表示して」

得られるもの： Claude は会話の記憶から推測する代わりに、ナレッジベースに対して 9 つの MCP ツールを呼び出せます。

3. Cursor または Claude Code のエージェントユーザー

エージェントはコードを書くのは得意ですが、プロジェクト全体の状況を見失いがちです。エージェントに、どのプロジェクトで作業中か、そのプロジェクトの状態が健全かを把握させたいと考えています。

まずは次のことから始めましょう：

• CPC を Cursor／Claude Code の MCP 設定に追加します（インストールを参照）
• 「Claude-Project-Coordinator のプロジェクトステータスを取得して」
• 「追跡中のプロジェクト全体の技術トレンドを取得して」
• 「過去 14 日間のアクティビティヒートマップを表示して」

得られるもの： プロジェクトの健全性とタイムラインがツールの結果として提供され、エージェントはそれを、すでに認識しているファイルと合わせて活用できます。

4. プライバシー優先／ローカルのみの環境

プロジェクト一覧をクラウドのプロジェクト管理ツールに送信したくありません。すべてをバイナリと同じ場所に保存したいと考えています。

まずは次のことから始めましょう：

• ソースからビルドし、MCP のパスに .build/release/project-coordinator を指定します
• 任意：CPC_KNOWLEDGE_BASE=~/Library/Application Support/CPC を設定して、Git ツリーの外にデータを保存します
• 公開リポジトリでは KnowledgeBase/projects/*.json をコミット対象から除外します（すでに gitignore に登録されています）

得られるもの： ディスク上の JSON、パスの許可リスト、アカウント不要、テレメトリーなしです。

5. すでにメモリ MCP を使用している場合

Memory Service などに決定事項や人物の情報を保存しています。会話の記録をもうひとつ増やしたくありません。

連携方法：

	CPC	Memory MCP
役割	プロジェクトの成果物とステータス	会話のコンテキストと決定事項
形式	構造化されたツール＋JSON ファイル	メモ、タグ、検索
質問例	「古くなっているプロジェクトはどれですか？」	「オンボーディングについて何を決めましたか？」

両方を使ってください。一方をもう一方の代わりにしないでください。

---

機能一覧

プロジェクトデスク

機能	詳細
複数のプロジェクトを追跡	名前、パス、説明、ステータス、メモ、現在のタスク、最終更新日時
パスから追加	パスを検証し、フォルダーをスキャンして、JSON レコードを保存
ステータス／メモを更新	別のアプリを使わずにデスクの情報を最新に維持
すべてを一覧表示	1 つのプロンプトで、技術スタックを含む全プロジェクトを表示
プロジェクトごとの詳細確認	ステータス、メモ、タスク、パス、検出されたテクノロジー

自動検出

プロジェクトを追加すると、CPC がフォルダーを調べ、検出した内容にタグを付けます。

• Swift Package Manager（Package.swift）
• Xcode プロジェクト（.xcodeproj）
• Xcode ワークスペース（.xcworkspace）
• SwiftUI（スキャンした Swift ファイル内の import SwiftUI）
• それ以外に該当するものがない場合は Swift を使用

検索とナレッジベース

機能	詳細
パターン検索	追跡中のプロジェクトと KnowledgeBase の Markdown ファイルを検索
組み込みガイド	Swift のパターン、SwiftUI の実践方法、Xcode のショートカット、トラブルシューティング
テンプレート	KnowledgeBase/templates/ にあるスタータードキュメント
独自ドキュメント	patterns/、tools/、または templates/ に Markdown を追加すると、検索で見つかるようになります

分析（自動）

専用のタイマーアプリは必要ありません。ステータスの更新とツールの使用状況が、バックグラウンドで分析データに反映されます。

ツール	わかること
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、…）
入力制限	名前、パス、メモ、検索文字列の長さに上限を設定
インジェクションチェック	検索パターンをシェル形式のペイロードが含まれていないか確認
環境変数による上書き	カスタムデータディレクトリには CPC_KNOWLEDGE_BASE を使用
Stdio に安全なログ	診断情報は stderr のみに出力（MCP ホストが stdout を使用）

---

すべての MCP ツール

ツール	パラメーター	目的
list_projects	—	追跡中のすべてのプロジェクトを一覧表示
add_project	name、path、省略可能な description	プロジェクトを登録し、テクノロジーを自動検出
get_project_status	projectName	1 つのプロジェクトの詳細を表示
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

Settings → Developer → 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. 古い再移行バグによって作成日が破損している場合：

./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 カレンダー、メモ、リマインダー。
• SeaShell。任意のターミナルブロックから Claude に話しかけます。
• TextEdit MCP。macOS TextEdit 経由で書式付き RTF ドキュメントを扱います。
• HubSpot Auditor。読み取り専用の HubSpot ポータル監査。

---

💖 このプロジェクトを支援する

CPC が開発ワークフローの効率化や、プロジェクト管理の時間短縮に役立った場合は、開発へのご支援をご検討ください：

ご支援により、次のことが可能になります：

• 新機能を追加しながら CPC を保守・改善する
• プロジェクトをオープンソースかつ誰でも無料で利用できる状態に保つ
• ユーザーからのご要望やバグ修正に、より多くの時間を充てる
• 開発者の生産性を高める新しいツールを探求する

ご支援をご検討いただき、ありがとうございます！🙏

---

貢献

貢献を歓迎します。バグの報告、機能の提案、プルリクエストの作成、または KnowledgeBase/ でのパターンやテンプレートの共有をお待ちしています。

ライセンス

MIT License。

謝辞

MCP エコシステム向けに構築されています。プロトコルスタック：modelcontextprotocol/swift-sdk。

---

🍍 Pineapple より ❤️ を込めて