MCP

🚀 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 以进行远程访问：

1. 安装包括 Vercel 适配器在内的依赖项：

   npm install @vercel/mcp-adapter zod
   

2. 部署到 Vercel：

   vercel
   

3. 配置你的 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