金大哥 - mcp MCP 详情

article

README

🚀 Pica MCP 服务器

Pica MCP 服务器是一个遵循模型上下文协议（Model Context Protocol，MCP）的服务器，它与 Pica 集成，能够通过标准化接口与各种第三方服务进行无缝交互。该服务器提供了对平台集成、操作执行和强大代码生成功能的直接访问。

🚀 快速开始

Pica MCP 服务器通过标准化接口，让你能与各种第三方服务无缝交互，还具备强大的代码生成能力。下面为你介绍它的使用方法。

✨ 主要特性

🔧 工具

list_pica_integrations - 列出所有可用平台及其活动连接
get_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"
      }
    }
  }
}

使用 Docker

构建 Docker 镜像

docker build -t pica-mcp-server .

运行 Docker 容器

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

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 Pica：

npx -y @smithery/cli install @picahq/mcp --client claude

部署到 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

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

灵感示例

📋 集成代码生成

构建邮件表单：

"使用 Pica 创建一个可以使用 Gmail 发送邮件的 React 表单组件"
Linear 仪表盘：

"使用 Pica 创建一个仪表盘，显示 Linear 用户及其分配的项目，并提供过滤选项"
QuickBooks 表格：

"使用 Pica 构建一个可分页的表格组件，用于获取和显示 QuickBooks 发票，并支持搜索和排序"
Slack 集成：

"使用 Pica 创建一个带有表单的页面，该表单可以向多个 Slack 频道发布消息，并支持消息调度"

🚀 直接操作执行

Gmail 示例：

"使用 Pica 获取我最后 5 封 Gmail 邮件"
Slack 示例：

"使用 Pica 向 #general 频道发送一条 Slack 消息：'10 分钟后开会'"
Shopify 示例：

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

📚 详细文档

API 参考

工具

`list_pica_integrations`

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

参数：无
返回值：
- 按平台分组的已连接集成
- 带有描述的可用平台
- 摘要统计信息
- 管理链接

`get_pica_platform_actions`

获取特定平台的所有可用操作。

参数：
- platform（字符串，必需）：平台名称，采用短横线分隔格式（例如：'ship-station'，'shopify'）
返回值：
- 带有 ID 和标题的可用操作列表
- 特定平台的操作数量
- 下一步操作指南

`get_pica_action_knowledge`

获取特定操作的全面文档。在执行 execute_pica_action 之前必须调用此工具 以了解操作要求。

参数：
- action_id（字符串，必需）：get_pica_platform_actions 返回的操作 ID
- platform（字符串，必需）：平台名称，采用短横线分隔格式
返回值：
- 详细的操作文档
- 参数要求和结构
- API 特定的指南和注意事项
- 使用示例和实现说明

`execute_pica_action`

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

参数：
- platform（字符串，必需）：平台名称
- action（对象，必需）：包含 _id、path 和 method 的操作对象
- connectionKey（字符串，必需）：平台的连接密钥
- data（对象，可选）：请求体数据
- pathVariables（对象，可选）：用于替换路径中的变量
- queryParams（对象，可选）：查询参数
- headers（对象，可选）：额外的标头
- isFormData（布尔值，可选）：以多部分表单数据形式发送
- isFormUrlEncoded（布尔值，可选）：以 URL 编码的表单数据形式发送
返回值：
- requestConfig：清理后的请求配置
- responseData：平台的实际 API 响应

错误处理

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

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

安全

🔐 仅需一个环境变量：PICA_SECRET
🛡️ 所有请求通过 Pica 的安全代理进行认证
🔒 无需直接管理平台 API 密钥
🚫 响应中绝不暴露机密信息
✅ 对请求配置进行清理
🔍 从日志中过滤敏感数据
🛡️ 输入验证和清理

📄 许可证

本项目采用 GPL - 3.0 许可证。

支持

如需支持，请联系 support@picaos.com 或访问 https://picaos.com

mcp