关键词

LLM集成Pica平台API访问工具调用上下文服务

项目简介

Pica MCP Server 是一个基于 Model Context Protocol (MCP) 标准构建的服务器，旨在作为大型语言模型 (LLM) 的桥梁，连接 Pica 平台。通过此服务器，LLM 应用可以安全、便捷地访问和利用 Pica 平台集成的各种连接和功能，例如调用外部 API、管理数据资源等。它允许用户通过自然语言指令，让 LLM 应用执行如发送邮件、创建日历事件、查询数据库等操作，极大地扩展了 LLM 的应用场景。

主要功能点

  • 资源管理: 通过 'pica-platform:' 和 'pica-connection:' URI 方案，向 LLM 客户端提供 Pica 平台支持的平台列表以及用户已配置的连接信息，作为可访问的资源。
  • 工具注册与执行: 注册了一系列工具，允许 LLM 客户端调用 Pica 平台的功能，包括：
    • 'list_connections': 列出用户 Pica 账户中所有激活的连接。
    • 'get_available_actions': 获取指定平台可用的所有操作。
    • 'get_action_knowledge': 获取特定操作的详细信息。
    • 'execute_action': 执行一个具体的操作，例如调用 API 接口。
  • 基于 Pica API: 服务器本身不直接连接外部服务，而是作为 Pica API 的客户端，所有功能都依赖于预先在 Pica 平台配置的连接和操作。
  • 简单的安装与配置: 提供详细的安装和配置说明，方便用户快速部署和使用。
  • 支持 Claude Desktop: 特别提供了与 Claude Desktop 集成的配置示例，方便 Claude 用户使用。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。
  2. 克隆仓库: 将 'pica-mcp' 仓库克隆到本地： 
    git clone https://github.com/picahq/pica-mcp.git
cd pica-mcp
  3. 安装依赖: 在仓库目录下运行以下命令安装项目依赖： 
    npm install
  4. 构建项目: 运行以下命令构建 TypeScript 代码： 
    npm run build

服务器配置

要将 Pica MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置客户端的服务器列表。以下是 Claude Desktop 的配置示例，你需要将配置信息添加到 'claude_desktop_config.json' 文件中。

配置文件路径:

  • MacOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容 (json):

{
  "mcpServers": {
    "pica-mcp-server": { <!-- 服务器名称，可以自定义 -->
      "command": "node",  <!-- 启动服务器的命令 -->
      "args": [         <!-- 启动命令的参数 -->
        "/path/to/pica-mcp-server/build/index.js" <!--  'index.js' 文件的绝对路径，请替换为实际路径 -->
      ],
      "env": {
        "PICA_SECRET": "YOUR_PICA_SECRET_KEY" <!-- Pica API 密钥，请替换为你的 Pica API 密钥 -->
      }
    }
  }
}

重要参数说明:

  • '"command": "node"': 指定使用 'node' 命令来运行服务器。
  • '"args": [...]': 指定传递给 'node' 命令的参数，这里是 'index.js' 文件的路径。请务必将 '/path/to/pica-mcp-server/build/index.js' 替换为 'index.js' 文件在你的系统中的实际绝对路径。 例如，如果你的 'pica-mcp' 仓库位于 '~/Documents/pica-mcp'，则路径可能为 '~/Documents/pica-mcp/build/index.js'。
  • '"env": { "PICA_SECRET": "YOUR_PICA_SECRET_KEY" }': 设置环境变量 'PICA_SECRET'，你需要将 '"YOUR_PICA_SECRET_KEY"' 替换为你在 Pica 平台 获取的 API 密钥。

获取 Pica API 密钥:

  1. 访问 Pica 平台。
  2. 登录你的 Pica 账户。
  3. 进入 "Settings" (设置) -> "API Keys" (API 密钥) 页面。
  4. 创建或复制你的 API 密钥。
  5. 将 API 密钥填入 'claude_desktop_config.json' 配置文件中的 '"PICA_SECRET"' 字段。

基本使用方法

  1. 启动 MCP 客户端: 重启或启动你的 MCP 客户端（例如 Claude Desktop）。
  2. 与 LLM 交互: 在 LLM 客户端中，你可以使用自然语言指令来调用 Pica MCP Server 提供的工具。例如：
    • 询问 "What connections do I have access to?" (我有哪些连接可用？) 来调用 'list_connections' 工具。
    • 询问 "What actions can I perform with google sheets?" (我可以使用 Google Sheets 做什么？) 来调用 'get_available_actions' 工具并指定平台为 "google sheets"。
    • 指示 "Send an email using gmail to [email protected]" (使用 Gmail 发送邮件给 [email protected]) 来调用 'execute_action' 工具，并指定相应的操作和参数（具体指令格式可能需要参考 Pica 平台的文档或示例）。

注意: 你需要先在 Pica 平台 中配置好所需的连接（例如 Gmail, Google Sheets, Slack 等），Pica MCP Server 才能访问和使用这些连接。

信息

分类

AI与计算

访问项目