Planning Center Online (PCO) MCP Server

规划中心在线API与MCP服务器集成

这个项目将规划中心在线（PCO）API与MCP服务器集成，以实现与大型语言模型（LLM）的无缝交互。目标是让用户能够以对话的方式提出问题并从规划中心检索数据。

特点/功能

• PCO API 集成连接到Planning Center Online以访问和管理数据。
• FASTMCP 服务器作为中间件，处理大型语言模型（LLM）和PCO API之间的请求和响应。
• 大型语言模型查询支持支持使用自然语言查询，以从规划中心获取和操作数据。

用例

• 在规划中心检索服务信息。
• 通过使用自然语言查询和更新数据来自动化工作流程。
• 通过对话式查询提供见解和分析。

入门指南

先决条件

• 访问 规划中心API.
• Python环境
• MCP 客户端（即 Claude 桌面版）
• 用于身份验证的API密钥。

安装

1. 克隆此存储库：

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

1. 安装依赖项：

   uv pip install -r requirements.txt 

1. 配置环境变量：

- PCO_SECRET_KEY您的规划中心API密钥。 - PCO_APPLICATION_IDMCP服务器的URL。

1. 测试服务器：

   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"
      }
    }
}

未来工作

计划继续在规划中心的其他领域开展工作。

贡献；做出贡献

欢迎贡献！如有任何建议或改进，请提交拉取请求或打开一个问题。

许可证

这个项目遵循以下许可协议： 麻省理工学院许可证.

资源

• 规划中心API文档
• FastMCP
• pypco 翻译成中文可以是“Pypco”（如果这是一个专有名词或品牌名，通常保持原样），或者根据上下文，如果“pypco”有特定的含义或是一个缩写，可以翻译成相应的中文意思。但在这里，由于没有具体的上下文，所以直接保留了原样。