项目简介
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。
- 打开终端或命令行工具。
- 运行以下命令安装 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服务器交互。
-
作为独立服务器启动 (用于测试或远程部署): 在终端中设置 '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 -
在支持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与计算