Claude Project Coordinator

🚀 Claude Project Coordinator

Claude Project Coordinatorは、複数のXcode/Swiftプロジェクトを管理および調整するためのMCP（Model Context Protocol）サーバーです。このサーバーは、プロジェクトの状態追跡、コードパターンの検索、開発の洞察に関する知識ベースの維持などのツールを提供します。

🚀 クイックスタート

v1.3.0+ユーザー向けの重要な更新

プロジェクトの作成日が誤って表示される（すべて今日の日付になっている）場合は、以下のコマンドを実行してください。

./scripts/repair-analytics-dates.sh

これにより、再起動のたびに分析データが再移行されるバグが修正されます。この修正はv1.3.2で適用されています。

インストールと設定

前提条件

• Swift 5.9以上を搭載したmacOS
• Claude Desktopアプリ

ソースからビルド

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 Desktopの設定

1. Claude Desktopを開きます。
2. 設定 → 開発者 → Model Context Protocolに移動します。
3. 以下の設定を追加します。

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

4. Claude Desktopを再起動します。

✨ 主な機能

• 🚀 プロジェクト管理：複数のXcodeプロジェクトの状態、ノート、メタデータを追跡します。
• 🔍 スマート検索：プロジェクトやドキュメント全体でコードパターンを検索します。
• 📚 知識ベース：コードパターン、テンプレート、トラブルシューティングガイドを維持します。
• 🤖 自動検出：SwiftUI、UIKit、SPMなどの技術を自動的に検出します。
• 💾 永続的なストレージ：すべてのデータが構造化されたJSON形式でローカルに保存されます。
• 🔐 セキュリティ第一：包括的な入力検証とパストラバーサル保護があります。
• 📊 プロジェクト分析：時間追跡、アクティビティヒートマップ、ヘルススコアリング（v1.3.0+）
• 📈 技術トレンド分析：フレームワークの使用状況と採用パターンを分析します（v1.3.0+）

🛡️ セキュリティ機能 (v1.2.0+)

• 🛡️ 入力検証：すべてのユーザー入力を包括的に検証します。
• 🚫 パストラバーサル保護：../../../etc/passwd のような悪意のあるパスをブロックします。
• 📁 ディレクトリアクセス制御：プロジェクトに許可されるディレクトリを設定可能です。
• 🚨 インジェクション防止：検索パターンを検証してコマンドインジェクションを防止します。
• ⚖️ 合理的な制限：入力長制限を設けてバッファオーバーフロー攻撃を防止します。
• 📝 明確なエラーメッセージ：セキュリティ検証が失敗した場合に役立つガイダンスを提供します。
• ⚙️ ハードコードされたセキュリティ：セキュリティポリシーがバイナリにコンパイルされて信頼性が高められています。

💻 使用例

基本的な使用法

• プロジェクトの一覧表示：「すべての追跡中のプロジェクトを表示して」
• プロジェクトの追加：「~/Developer/WeatherAppにあるWeatherAppプロジェクトを追加して」
• ステータスの更新：「WeatherAppのステータスを 'API統合の実装中' に更新して」
• パターンの検索：「すべてのSwiftUIパターンを検索して」
• プロジェクトの詳細取得：「TodoAppのステータスはどうですか？」

高度な使用法

分析コマンド (v1.3.0+)

• 時間追跡：「Ubermaniaの開発にどれだけの時間がかかっていますか？」
• アクティビティヒートマップ：「今週のプロジェクトアクティビティを表示して」
• 技術トレンド：「最も多く使用している技術は何ですか？」
• ヘルスチェック：「どのプロジェクトに注意が必要ですか？」

📊 詳細な出力例と有用なプロンプトについては、ANALYTICS-EXAMPLES.md を参照してください！

ワークフローの例

あなた: 「~/Developer/FinanceTrackerにあるFinanceTrackerという新しいSwiftUIプロジェクトを追加して」
Claude: 「プロジェクトを正常に追加しました: FinanceTracker...」

あなた: 「FinanceTrackerのステータスを 'Core Dataモデルの開発中' に更新して」
Claude: 「FinanceTrackerを正常に更新しました」

あなた: 「Core Dataを使用しているプロジェクトはどれですか？」
Claude: [Core Dataを技術スタックまたはノートに含むすべてのプロジェクトを表示]

分析出力の例

あなた: 「今週のプロジェクトアクティビティを表示して」

Claude:
## プロジェクトアクティビティヒートマップ (過去7日間)

🔥🔥🔥 **TodoApp** (15アクティビティポイント - 6イベント)
🔥🔥 **WeatherStation** (8アクティビティポイント - 3イベント)
🔥 **PortfolioSite** (3アクティビティポイント - 2イベント)
💤 **OldBlogEngine** (0アクティビティポイント)

### 日別アクティビティの内訳:
- 月曜日: 4イベント
- 火曜日: 8イベント
- 水曜日: 3イベント

🔧 技術詳細

• 外部依存関係を使用せずにSwiftで構築されています。
• MCP通信にJSON-RPCを使用しています。
• 最新のSwift並行性のためにAsync/awaitを使用しています。
• スレッドセーフのためにアクターベースのアーキテクチャを採用しています。
• 包括的な入力検証とセキュリティ強化が施されています。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。自由に使用してください！

🤝 貢献の方法

貢献は大歓迎です！以下のことを自由に行ってください。

• バグの報告
• 新機能の提案
• プルリクエストの提出
• ドキュメントの改善
• コードパターンやテンプレートの共有

🤗 プロジェクトのサポート

もしClaude Project Coordinatorがあなたの開発ワークフローを効率化したり、プロジェクト管理の時間を節約したりしてくれた場合、開発をサポートすることを検討してください。

あなたのサポートにより、私は以下のことができます。

• 新機能を追加してClaude Project Coordinatorを維持・改善する
• プロジェクトをオープンソースで無料で提供し続ける
• ユーザーの要望やバグ修正により多くの時間を費やす
• 開発者の生産性を向上させる新しいツールを探索する

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