MCP服务器

Name: MCP服务器
Author: picahq

作者：picahq8 星标更新：2025-10-22

安装使用来源：spider==github.com

项目介绍

Pica MCP Server

一个与Pica集成的模型上下文协议 (MCP)服务器，通过标准化接口实现与各种第三方服务的无缝交互。此服务器提供对平台集成、操作、执行能力和强大的代码生成能力的直接访问。

功能

🔧 工具

list_pica_integrations - 列出所有可用平台及您的活动连接
search_pica_platform_actions - 搜索特定平台上的可用操作
get_pica_action_knowledge - 获取特定操作的详细文档，包括参数和用法
execute_pica_action - 执行带有完整参数支持的API操作

主要能力

🔌 平台集成

通过Pica连接到100多个平台
管理每个平台的多个连接
访问实时连接状态

🎯 智能意图检测

立即执行操作（例如："读取我最近的Gmail邮件"，"向Slack频道#general发送消息"）
生成集成代码（例如："构建一个使用Gmail发送电子邮件的表单"，"创建一个用于消息传递的UI"）
智能上下文处理

🔒 增强的安全性

在生成的代码中从不暴露秘密
使用环境变量：PICA_SECRET，PICA_[PLATFORM]_CONNECTION_KEY
生产使用的请求配置经过清理

⚡ 直接执行

通过MCP界面直接执行操作
支持所有HTTP方法（GET、POST、PUT、DELETE等）
处理表单数据、URL编码和JSON负载
传递路径变量、查询参数和自定义头

🔒 安全认证

所有请求通过Pica的安全代理进行身份验证
不需要管理各个平台的API密钥
通过环境变量配置安全

安装

npm install @picahq/mcp

配置

PICA_SECRET=your-pica-secret-key

在Pica仪表板获取您的Pica密钥。

使用

作为独立服务器

npx @picahq/mcp

在Claude Desktop中

要在Claude Desktop中使用，请添加服务器配置：

在MacOS上：~/Library/Application\ Support/Claude/claude_desktop_config.json

在Windows上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pica": {
      "command": "npx",
      "args": ["@picahq/mcp"],
      "env": {
        "PICA_SECRET": "your-pica-secret-key"
      }
    }
  }
}

在Cursor中

在Cursor菜单中选择“MCP设置”，并更新MCP JSON文件以包含以下内容：

{
  "mcpServers": {
    "pica": {
      "command": "npx",
      "args": ["@picahq/mcp"],
      "env": {
        "PICA_SECRET": "your-pica-secret-key"
      }
    }
  }
}

使用远程MCP服务器

远程MCP服务器可在https://mcp.picaos.com访问。

使用Docker

构建Docker镜像：

docker build -t pica-mcp-server .

运行Docker容器：

docker run -e PICA_SECRET=your_pica_secret_key pica-mcp-server

部署到Vercel

您可以将此MCP服务器部署到Vercel以供远程访问：

安装依赖项，包括Vercel适配器：
```
npm install @vercel/mcp-adapter zod
```
部署到Vercel：
```
vercel
```
配置您的MCP客户端以使用远程服务器：
- 对于Cursor：https://your-project.vercel.app/api/mcp
- 对于Claude/Cline：使用npx mcp-remote https://your-project.vercel.app/api/mcp

详情请参阅DEPLOYMENT.md中的Vercel部署说明。

示例灵感

📋 集成代码生成

构建电子邮件表单：

"创建一个React表单组件，可以使用Gmail发送电子邮件"

Linear仪表盘：

"创建一个仪表盘，显示Linear用户及其分配的项目，并具有过滤选项"

QuickBooks表格：

"构建一个可分页的表格组件，获取并显示QuickBooks发票，具有搜索和排序功能"

Slack集成：

"创建一个页面，其中包含一个表单，可以向多个Slack频道发布带有调度的消息"

🚀 直接操作执行

Gmail示例：

"使用Pica获取我最近的5封Gmail邮件"

Slack示例：

"使用Pica向#general频道发送消息：'10分钟后开会'"

Shopify示例：

"使用Pica获取我的Shopify商店中的所有产品"

API参考

工具

`list_pica_integrations`

列出所有可用的Pica集成和平台。始终首先调用此工具以发现可用平台和连接。

参数： 无

返回：

connections：用户活动连接的数组，包括平台和键
availablePlatforms：活动平台的数组，包括名称和类别
summary：统计信息，包括已连接和可用的数量

`search_pica_platform_actions`

使用查询搜索特定平台的相关操作。根据向量相似度搜索返回最相关的前5个动作。

参数：

platform（字符串，必需）：以短横线格式表示的平台名称（如：'ship-station'，'shopify'）
query（字符串，必需）：描述您想要做什么的搜索查询（如：'搜索联系人'，'创建发票'，'发送电子邮件'）
agentType（枚举，可选）：代理上下文类型 - 要么是"execute"或"knowledge"。如果未指定，默认为"knowledge"
- 当用户想要执行操作时使用"execute"
- 当用户想要获取信息或编写代码时使用"knowledge"

返回：

actions：最多5个最相关动作的数组，每个动作包括：
- actionId：动作的唯一标识符
- title：人类可读的动作名称
- method：HTTP方法（GET、POST等）
- path：API端点路径
metadata：搜索元数据，包括平台、查询和结果数量

`get_pica_action_knowledge`

获取特定操作的全面文档。必须在执行execute_pica_action之前调用以理解需求。

参数：

actionId（字符串，必需）：来自search_pica_platform_actions的动作ID
platform（字符串，必需）：以短横线格式表示的平台名称

返回：

动作的详细文档
参数要求和结构
API特定指导和注意事项
使用示例和实施说明

`execute_pica_action`

执行Pica操作以在第三方平台上执行操作。**重要：**仅当用户想要执行操作时才调用此操作，而不是在构建应用程序时。

参数：

platform（字符串，必需）：平台名称
actionId（字符串，必需）：来自search_pica_platform_actions的动作ID
connectionKey（字符串，必需）：平台的连接键
data（对象，可选）：请求正文数据
pathVariables（对象，可选）：替换路径中的变量
queryParams（对象，可选）：查询参数
headers（对象，可选）：附加头
isFormData（布尔值，可选）：作为multipart/form-data发送
isFormUrlEncoded（布尔值，可选）：作为URL编码的表单数据发送

返回：

requestConfig：清理过的请求配置
responseData：平台的实际API响应

错误处理

服务器实现了全面的错误处理：

✅ 所有工具的参数验证
✅ 执行前的连接验证
✅ 路径变量验证和替换
✅ API失败的优雅处理
✅ 调试的详细错误消息
✅ 符合MCP标准的错误响应

安全

🔐 单一环境变量：PICA_SECRET
🛡️ 所有请求通过Pica的安全代理进行身份验证
🔒 不需要直接管理平台API密钥
🚫 响应中从不暴露秘密
✅ 请求配置经过清理
🔍 过滤日志中的敏感数据
🛡️ 输入验证和清理

许可证

MIT

支持

如有问题，请联系support@picaos.com或访问https://picaos.com