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": "/Users/calvarychapelnewharvest/anaconda3/envs/mcp/bin/fastmcp",
      "args": [
        "run",
        "/Users/calvarychapelnewharvest/Documents/pco-mcp/services.py"
      ]
    }
  }
}

未来工作

计划继续研究 Planning Center 的其他领域。

贡献

欢迎贡献！请提交 pull request 或打开 issue，提出任何建议或改进。

许可证

本项目根据 MIT 许可证 获得许可。

资源

• Planning Center API 文档
• FastMCP
• pypco