关键词

SaaS集成工具调用LLM应用API连接自动化

项目简介

Ampersand MCP服务器是Model Context Protocol (MCP) 的一个实现，旨在让大型语言模型（LLM）通过标准协议访问Ampersand平台提供的150+ SaaS应用连接器和工具。它允许LLM执行如创建/更新记录、检查连接、发起认证流程以及调用SaaS API等操作，从而为LLM应用提供强大的外部能力。

主要功能点

  • SaaS工具调用: 允许LLM通过结构化的工具接口调用Ampersand平台集成的各种SaaS应用功能。
  • 数据写入: 支持在连接的SaaS应用中创建和更新记录。
  • 连接与安装管理: 提供检查现有Ampersand连接和集成安装状态、创建新安装的工具，帮助LLM了解和管理与SaaS应用的连接。
  • OAuth认证流程: 支持通过OAuth流程连接到新的SaaS提供商，并返回认证链接供用户在MCP客户端中点击完成认证。
  • API代理调用: 允许LLM通过Ampersand代理向连接的SaaS提供商的任意API端点发送通用请求（GET, POST等），实现更灵活的交互。
  • 多传输协议: 支持通过标准输入输出（Stdio）和Server-Sent Events (SSE) 与兼容的MCP客户端（如Cursor、Claude Desktop等）通信。

安装步骤

该项目通常作为npm包提供，您可以在您的项目中使用它，或者通过'npx'直接运行服务器。

要作为库在项目中使用，需要安装npm包：

npm install @amp-labs/ai @modelcontextprotocol/sdk
# 或使用 yarn
yarn add @amp-labs/ai @modelcontextprotocol/sdk
# 或使用 pnpm
pnpm add @amp-labs/ai @modelcontextprotocol/sdk

直接运行服务器（例如用于本地开发或Stdio模式，通常需要安装Node.js）：

npx @amp-labs/mcp-server@latest --transport stdio ...

服务器配置

MCP客户端（如Cursor、Claude Desktop等）需要配置连接到此MCP服务器。典型的配置信息如下（具体配置取决于您的MCP客户端和使用模式，请将占位符替换为您自己的Ampersand凭据）：

Stdio模式 (Example for 'mcp.json'):

{
  "mcpServers": {
    "@amp-labs/mcp-server": {
      "command": "npx", // 用于启动MCP服务器进程的命令
      "args": [
        "-y",
        "@amp-labs/mcp-server@latest",
        "--transport", "stdio", // 指定服务器使用的传输协议（标准输入输出）
        "--project", "<AMPERSAND_PROJECT_ID>", // 您的Ampersand项目ID
        "--integrationName", "<AMPERSAND_INTEGRATION_NAME>", // 您的Ampersand集成名称
        "--groupRef", "<AMPERSAND_GROUP_REF>" // 您的Ampersand分组参考
      ],
      "env": {
        "AMPERSAND_API_KEY": "<YOUR_AMPERSAND_API_KEY>" // 您的Ampersand API Key（通过环境变量传递）
      }
    }
  }
}

请将 '<AMPERSAND_PROJECT_ID>', '<AMPERSAND_INTEGRATION_NAME>', '<AMPERSAND_GROUP_REF>', '<YOUR_AMPERSAND_API_KEY>' 替换为您自己的Ampersand平台凭据。

SSE模式 (Example for 'mcp.json'):

如果您的MCP客户端支持HTTP Headers，推荐使用Header传递API Key：

{
  "mcpServers": {
    "@amp-labs/mcp-server": {
      "url": "https://mcp.withampersand.com/v1/sse?project=<AMPERSAND_PROJECT_ID>&integrationName=<AMPERSAND_INTEGRATION_NAME>&groupRef=<AMPERSAND_GROUP_REF>", // 远程SSE服务器的URL，包含项目和集成参数
      "headers": {
        "x-api-key": "<YOUR_AMPERSAND_API_KEY>" // 您的Ampersand API Key（通过Header传递）
      }
    }
  }
}

如果您的MCP客户端不支持HTTP Headers，您也可以通过URL参数传递API Key：

{
  "mcpServers": {
    "@amp-labs/mcp-server": {
      "url": "https://mcp.withampersand.com/v1/sse?apiKey=<YOUR_AMPERSAND_API_KEY>&project=<AMPERSAND_PROJECT_ID>&integrationName=<AMPERSAND_INTEGRATION_NAME>&groupRef=<AMPERSAND_GROUP_REF>" // 远程SSE服务器的URL，包含所有参数
    }
  }
}

请将 '<AMPERSAND_PROJECT_ID>', '<AMPERSAND_INTEGRATION_NAME>', '<AMPERSAND_GROUP_REF>', '<YOUR_AMPERSAND_API_KEY>' 替换为您自己的Ampersand平台凭据。远程SSE服务器通常由Ampersand托管。

基本使用方法

配置完成后，您的MCP客户端（如Cursor、Claude Desktop等）将自动连接到此服务器，并发现其提供的工具。您可以在与LLM交互时，通过自然语言或工具调用语法来指示LLM使用这些工具，例如：

  • “请检查我的Hubspot连接是否正常。” (可能调用 'check-connection' 工具)
  • “在Salesforce中创建一个名为'Acme Corp'的新客户记录。” (可能调用 'create-record' 工具)
  • “使用Slack API发送一条消息到通用频道，内容是'会议已取消'。” (可能调用 'send-request' 工具)

LLM会根据对话上下文和其能力选择并调用合适的工具，服务器将执行相应的操作并通过MCP协议返回结果。

信息

分类

AI与计算

访问项目