Pco MCP

該項目通過集成Planning Center Online API與MCP服務器，實現用戶通過自然語言查詢和操作Planning Center數據的功能。

人工智能聊天機器人日程管理 #API集成 #自然語言查詢 #工作流自動化 .Python

評分 : 2分

下載量 : 19

更新時間 : 2025-04-28

What is PCO-MCP Integration?

This service connects your Planning Center Online account with a conversational AI interface. It allows you to ask questions and manage church data using natural language instead of manual searching.

How to Use This Service?

Simply ask questions about your Planning Center data in natural language through the MCP client interface. The system will understand your request and fetch the relevant information automatically.

Ideal Use Cases

Perfect for church staff and volunteers who need quick access to service schedules, team member information, or want to automate routine data lookups without navigating complex interfaces.

Key Features

PCO API IntegrationSecure connection to your Planning Center account to access services, people, and scheduling data.

Natural Language QueriesAsk questions about your church data in plain English instead of using complex search interfaces.

Workflow AutomationAutomate common tasks like checking schedules or finding team availability through simple commands.

Benefits and Limitations

Benefits

Saves time by eliminating manual data lookups

Accessible to non-technical users through natural language

Reduces training needed for Planning Center navigation

Limitations

Requires initial setup and API configuration

Limited to read-only operations in current version

Depends on Planning Center API availability

Getting Started

Install Dependencies

Set up Python environment and install required packages using the provided requirements file.

Configure API Keys

Add your Planning Center API credentials to the environment variables.

Start MCP Server

Launch the server to begin processing requests.

Configure MCP Client

Add the server configuration to your MCP client (like Claude Desktop).

Example Use Cases

Service Schedule LookupQuickly check who is scheduled for upcoming services

Team AvailabilityFind available team members for a specific date

Service PlanningGet details about planned services

Frequently Asked Questions

Is my Planning Center data secure with this integration?

Can I modify data through this interface?

What if the AI misunderstands my question?

Helpful Resources

Planning Center API Documentation

Official API reference for Planning Center Online

FastMCP GitHub

Source code and documentation for the MCP server framework

pypco Library

Python wrapper for Planning Center API

🚀 與 MCP 服務器集成的在線計劃中心 (PCO) API 集成

本項目致力於將在線計劃中心（PCO）API 與 MCP 服務器進行集成，從而實現與大型語言模型（LLM）的無縫交互。其核心價值在於，讓用戶能夠以自然語言的方式發起提問，輕鬆從計劃中心獲取所需數據。

✨ 主要特性

PCO API 集成：可連接到在線計劃中心，實現對數據的訪問與管理。
FASTMCP 服務器：作為中間件，高效處理 LLM 和 PCO API 之間的請求與響應。
LLM 查詢支持：支持使用自然語言進行查詢，方便從計劃中心獲取並操作數據。

🚀 快速開始

先決條件

需擁有在線計劃中心 API 的訪問權限。
配置 Python 環境。
準備 MCP 客戶端（例如 Claude Desktop）。
獲取用於身份驗證的 API 密鑰。

📦 安裝指南

克隆此倉庫：

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

安裝依賴項：

uv pip install -r requirements.txt

配置環境變量：
- PCO_SECRET_KEY：您的在線計劃中心 API 密鑰。
- PCO_APPLICATION_ID：MCP 服務器的 URL。
測試服務器：

fastmcp dev services.py

💻 使用示例

基礎用法

發送自然語言查詢到 MCP 服務器。
服務器處理查詢並與在線計劃中心 API 交互。
收到結構化響應或執行請求的操作。

高級用法

添加 MCP 服務器配置：

{
  "mcpServers": {
    "pco-services": {
      "command": "/Users/calvarychapelnewharvest/anaconda3/envs/mcp/bin/fastmcp",
      "args": [
        "run",
        "/Users/calvarychapelnewharvest/Documents/pco-mcp/services.py"
      ]
    }
  }
}