Planning Center MCP

🚀 Planning Center MCP Server

このFastMCPサーバーは、Planning Center People API用のツールを提供します。このサーバーは、JSON API仕様1.0を使用して、Planning Centerからの人物データを照会およびフィルタリングするためのMCP（Model Context Protocol）ツールを実装しています。

✨ 主な機能

MCPサーバーは、Planning Centerのデータを照会するための以下のツールを提供します。

• list_people_with_approved_background_checks：バックグラウンドチェックが承認されたすべての人物を取得します。
• list_people_with_role：特定の役割を持つ人物を検索します。
• list_people_by_age_range：年齢範囲で人物をフィルタリングします。
• list_people_by_gender：性別で人物をフィルタリングします。
• list_people_with_household：世帯に所属する人物を取得します。
• list_people_in_family：特定の家族名/姓を持つ人物を検索します。
• list_people_with_membership：特定の会員タイプを持つ人物を取得します。
• search_people：名前、メールアドレス、またはその他の識別情報で人物を検索します。
• get_person_details：特定の人物の詳細情報を取得します。

📦 インストール

1. 依存関係のインストール

このプロジェクトは、依存関係の管理にuvを使用しています。

uv sync

2. 環境変数の設定

サンプルの環境ファイルをコピーし、Planning Centerの認証情報を追加します。

cp .env.example .env

.envを編集し、Planning Center APIの認証情報を追加します。

PLANNING_CENTER_CLIENT_ID=your_client_id_here
PLANNING_CENTER_SECRET=your_secret_here

Planning Center API認証情報の取得方法

1. https://api.planningcenteronline.com/oauth/applications にアクセスします。
2. 新しいアプリケーションを作成します。
3. クライアントIDとシークレットを.envファイルにコピーします。

3. MCPサーバーの起動

uv run planning-center-mcp

または、Pythonで直接起動することもできます。

uv run python main.py

Claude Desktopとの統合

このMCPサーバーをClaude Desktopと一緒に使用するには、Claude Desktopの設定ファイルに以下の設定を追加します。

場所: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "planning-center": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/Users/eric.foster/projects/plan-cp",
        "planning-center-mcp"
      ]
    }
  }
}

/Users/eric.foster/projects/plan-cpを実際のプロジェクトディレクトリのパスに置き換えてください。

レート制限

Planning Centerは、1分あたり100回のリクエストのレート制限があります。MCPサーバーは、リクエストを追跡し、制限を超えた場合にエラーをスローすることで、自動的にこれを処理します。

API準拠

このサーバーは、Planning CenterのJSON API仕様1.0と互換性があり、仕様に従って適切なフィルタリング、照会、およびデータ形式を処理します。

開発

プロジェクト構造

planning-center-mcp/
├── main.py              # メインのMCPサーバー実装
├── pyproject.toml       # プロジェクトの設定と依存関係
├── .env.example         # サンプルの環境変数
├── .env                 # あなたの環境変数 (git管理外)
├── .gitignore          # Gitの無視ファイル
└── README.md           # このファイル

テスト

MCPサーバーをローカルで起動し、ログを確認することでテストすることができます。実際の認証情報が提供されていない場合、サーバーはデモ認証情報を使用しますが、機能は制限されます。

トラブルシューティング

1. 認証エラー：.envファイルにPlanning Centerの認証情報が正しく設定されていることを確認してください。
2. レート制限：レート制限に達した場合は、もう一度リクエストを行う前に1分待ってください。
3. 接続エラー：インターネット接続とPlanning Center APIのステータスを確認してください。

📄 ライセンス

このプロジェクトはオープンソースです。詳細については、ライセンスファイルを参照してください。