项目简介

Pica MCP 服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在将Pica平台与大型语言模型(LLM)客户端(如Claude Desktop, Cursor等)连接起来。它通过提供标准化的接口,使LLM能够访问Pica集成的100多个第三方服务,进行数据查询、执行操作,甚至生成集成代码。其核心功能是作为LLM的上下文提供者和功能执行者,极大地扩展了LLM的应用范围。

主要功能点

  • 平台集成管理: 能够列出用户所有已连接的Pica集成平台,以及所有可用的第三方服务平台。
  • 智能动作搜索: 根据LLM的意图和特定平台,搜索并推荐可执行的API动作(如“搜索联系人”、“发送邮件”)。
  • 动作知识获取: 提供详细的API动作文档,包括参数、用法和注意事项,帮助LLM理解如何正确调用API。
  • 直接动作执行: 允许LLM直接通过MCP服务器执行第三方平台的API动作,例如“获取最近5封Gmail邮件”、“发送Slack消息”。
  • 代码生成支持: 支持LLM根据API知识和用户需求,生成集成第三方服务的代码(如React表单组件、仪表盘等)。
  • 安全认证: 通过Pica的安全代理处理所有请求认证,无需管理单独的第三方API密钥,仅需一个Pica密钥。

安装步骤

确保您的系统已安装 Node.js 和 npm。

  1. 打开终端或命令行工具。
  2. 运行以下命令安装 Pica MCP 服务器包:
    npm install @picahq/mcp

服务器配置

MCP服务器需要一个'PICA_SECRET'密钥才能与Pica平台通信。您可以从 Pica dashboard 获取此密钥。

在您的MCP客户端(如Claude Desktop或Cursor)中配置Pica MCP服务器时,需要提供服务器的启动命令、参数和环境变量。以下是一个配置示例(请勿直接复制代码,而是理解其含义并根据客户端界面进行配置):

  • 服务器名称 (server name): 'pica' (或您希望的任何名称)
  • 启动命令 (command): 'npx'
  • 命令参数 (args): '["@picahq/mcp"]'
  • 环境变量 (env):
    • 'PICA_SECRET': 您的Pica密钥,例如 'your-pica-secret-key'

例如,在Claude Desktop或Cursor的MCP设置中,您会找到一个JSON文件或界面来添加服务器配置,类似这样:

{
  "mcpServers": {
    "pica": {
      "command": "npx",
      "args": ["@picahq/mcp"],
      "env": {
        "PICA_SECRET": "your-pica-secret-key" // 替换为您的Pica密钥
      }
    }
  }
}

基本使用方法

安装和配置完成后,您的MCP客户端将能够发现并与Pica MCP服务器交互。

  1. 作为独立服务器启动 (用于测试或远程部署): 在终端中设置 'PICA_SECRET' 环境变量,然后运行:

    PICA_SECRET=your-pica-secret-key npx @picahq/mcp

    或者使用 Docker 启动:

    docker build -t pica-mcp-server .
    docker run -e PICA_SECRET=your_pica_secret_key pica-mcp-server
  2. 在支持MCP的LLM客户端中使用: 一旦在Claude Desktop或Cursor中配置好,LLM即可通过对话直接调用Pica的功能。例如:

    • "列出我所有已连接的Pica集成。" (调用 'list_pica_integrations')
    • "搜索Gmail平台上有什么操作可以用来发送邮件?" (调用 'search_pica_platform_actions')
    • "获取关于Gmail发送邮件操作的详细文档。" (调用 'get_pica_action_knowledge')
    • "发送一条Slack消息到 #general 频道,内容是 '会议10分钟后开始'。" (调用 'execute_pica_action')
    • "为我创建一个React表单,可以使用Gmail发送邮件。" (LLM利用获取的知识进行代码生成)

信息

分类

AI与计算