Pco MCP

该项目通过集成Planning Center Online API与MCP服务器，实现用户通过自然语言查询和操作Planning Center数据的功能。

人工智能聊天机器人日程管理 #API集成 #自然语言查询 #工作流自动化 .Python

评分 : 2分

下载量 : 25

更新时间 : 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"
      ]
    }
  }
}