Planning Center Online API and MCP Server Integration

Planning Center Online API 与 MCP 服务集成

此项目将 Planning Center Online（PCO）API 与 MCP 服务集成，以便与大模型无缝交互。目标是让用户能够以对话方式提问并检索 Planning Center 中的数据。

功能

• PCO API 集成：连接到 Planning Center Online，以访问和管理数据。
• FASTMCP 服务：充当中间件，处理大模型与 PCO API 之间的请求和响应。
• 大模型查询支持：支持使用自然语言查询，以获取和操作 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