MCP

🚀 Pica MCP Server

Pica MCP Server 是一個 Model Context Protocol (MCP) 服務器，它與 Pica 集成，可通過標準化接口與各種第三方服務進行無縫交互。該服務器提供對平臺集成、操作、執行能力和強大代碼生成能力的直接訪問。

🚀 快速開始

Pica MCP Server 集成了 Pica，可通過標準化接口與第三方服務無縫交互，提供平臺集成、操作執行和代碼生成等能力。

✨ 主要特性

🔧 工具

• 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 中使用

在以下路徑的配置文件中添加服務器配置：

• 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 Settings”，並更新 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 安裝

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 頻道發送消息：‘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。