Planning Center Online API and MCP Server Integration

Planning Center Online API と MCP サーバーの統合

このプロジェクトは、Planning Center Online（PCO）API と MCP サーバーを統合し、LLM とのシームレスなやり取りを可能にします。ユーザーが会話形式で質問し、Planning Center からデータを取得できるようにすることを目指しています。

機能

• PCO API の統合：Planning Center Online に接続し、データにアクセスして管理します。
• FASTMCP サーバー：LLM と PCO API 間のリクエストとレスポンスを処理するミドルウェアとして機能します。
• LLM クエリのサポート：自然言語でのクエリを通じて、Planning Center からデータを取得、操作できます。

ユースケース

• Planning Center のサービスに関する情報を取得します。
• 自然言語でデータを照会、更新してワークフローを自動化します。
• 会話形式のクエリを通じて、インサイトや分析結果を提供します。

はじめに

前提条件

• Planning Center API へのアクセス権。
• Python 環境
• MCP クライアント（例：Claude Desktop）
• 認証用 API キー。

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/your-repo/pco-mcp-integration.git  
   

2. 依存関係をインストールします：

   uv pip install -r requirements.txt 
   

3. 環境変数を設定します：

   • PCO_SECRET_KEY：Planning Center API キー。
   • PCO_APPLICATION_ID：MCP サーバーの URL。

4. サーバーをテストします：

   fastmcp dev services.py
   

使用方法

1. MCP サーバーに自然言語でクエリを送信します。
2. サーバーがクエリを処理し、PCO API とやり取りします。
3. 構造化されたレスポンスを受け取るか、要求した操作を実行します。

MCP サーバーの設定を追加

{
  "mcpServers": {
    "pco-services": {
      "command": "/path/to/fastmcp",
      "args": ["run", "/path/to/services.py"],
      "env": {
        "PCO_APPLICATION_ID": "PCO_CLIENT_ID",
        "PCO_SECRET_KEY": "PCO_CLIENT_SECRET_KEY"
      }
    }
}

今後の作業

Planning Center の他の領域についても、引き続き作業を進める予定です。

コントリビューション

コントリビューションを歓迎します！提案や改善点があれば、プルリクエストを送信するか、イシューを作成してください。

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。

リソース

• Planning Center API のドキュメント
• FastMCP
• pypco