由ACI.dev提供支持的 MCP 服务器

有关 MCP 服务器的完整文档和教程，请访问aci.dev docs 。

概述

有关 MCP 服务器的完整文档和教程，请访问aci.dev docs 。

该软件包提供了两个用于访问ACI.dev管理功能（工具）的模型上下文协议 (MCP) 服务器：

aipolabs-mcp-apps ：一个 MCP 服务器，可直接访问指定应用程序的功能（工具）
aipolabs-mcp-unified ：一个 MCP 服务器，提供两个元函数（工具）（ ACI_SEARCH_FUNCTIONS_WITH_INTENT和ACI_EXECUTE_FUNCTION ），用于发现和执行ACI.dev上可用的所有函数（工具）。

先决条件

在使用此包之前，您需要（有关更多信息，请参阅教程）：

使用您的ACI.dev API 密钥设置AIPOLABS_ACI_API_KEY环境变量
配置应用程序并在platform.aci.dev上为您的代理在allowed_apps中设置它们。
将你的应用特定帐户链接到相同的--linked-account-owner-id下，稍后你将提供该 ID 来启动 MCP 服务器

安装

该包已发布到 PyPI，因此您可以使用uvx直接运行它：

# Install uv if you don't have it already
curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

用法

应用服务器

应用服务器提供对特定应用下功能（工具）的直接访问。您可以使用--apps参数指定一个或多个要使用的应用。（如需查看可用应用的列表，请访问ACI.dev ）

# Using stdio transport (default)
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# Using SSE transport with custom port
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --transport sse --port 8000

统一服务器

统一服务器提供了两个元函数（工具）来发现和执行ACI.dev上可用的任何函数（工具），即使它们没有直接列在服务器中。

这些函数（工具）会根据您的意图/需求动态搜索并执行。您无需担心数千个工具占用 LLM 的上下文窗口，也无需集成多个 MCP 服务器。

# During functions (tools) search/discovery, allow discoverability of all functions (tools) available on ACI.dev
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# During functions (tools) search/discovery, limit to only functions (tools) accessible by the requesting agent (identified by AIPOLABS_ACI_API_KEY)
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --allowed-apps-only

了解两种服务器类型

有关 MCP 服务器的完整文档和教程，请访问aci.dev docs 。

应用服务器

应用服务器提供对您使用--apps参数指定的特定应用功能/工具的直接访问。当 MCP 客户端（例如 Claude Desktop、Cursor 等）与此服务器交互时，这些工具将直接显示在工具列表中。

统一服务器

统一服务器不直接公开特定于应用的工具。相反，它提供了两个元函数（工具）：

ACI_SEARCH_FUNCTIONS_WITH_INTENT ：根据您的意图/需求发现功能（工具）
ACI_EXECUTE_FUNCTION ：执行搜索发现的任何函数（工具）

这种方法允许 MCP 客户端动态发现并使用ACI.dev平台上的任何功能，而无需预先列出所有功能。它可以根据您的需求搜索合适的工具并执行。

配置

有关 MCP 服务器的完整文档和教程，请访问aci.dev docs 。

与 Claude Desktop 一起使用

将其添加到您的claude_desktop_config.json中：

{
  "mcpServers": {
    "aipolabs-mcp-unified": {
      "command": "uvx",
      "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
    }
  }
}

对于特定于应用程序的访问：

{
  "mcpServers": {
    "aipolabs-mcp-apps": {
      "command": "uvx",
      "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"]
    }
  }
}

与游标一起使用

添加到你的 Cursor mcp.json ：

{
    "mcpServers": {
      "aipolabs-mcp-unified": {
        "command": "uvx",
        "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
        "env": {
            "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
        }
      }
    }
  }

对于特定于应用程序的访问：

{
  "mcpServers": {
    "aipolabs-mcp-apps": {
        "command": "uvx",
        "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"],
        "env": {
            "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>"
        }
    }
  }
}

常问问题

如何获取AIPOLABS_ACI_API_KEY ？AIPOLABS_ACI_API_KEY是您的ACI.dev项目的 API 密钥。您可以在ACI.dev项目设置中找到它。
如何配置应用程序并允许访问它们？您可以在ACI.dev项目设置中配置应用程序并允许访问它们。
如何获取LINKED_ACCOUNT_OWNER_ID ？LINKED_ACCOUNT_OWNER_ID是您要用于访问这些功能的账户 ID。您可以在ACI.dev项目设置中找到它。
与应用服务器相比，使用统一服务器有什么好处？目前大多数 MCP 服务器都仅限于一组特定的功能（工具），通常来自单个应用程序。如果您需要使用来自多个应用程序的功能，则需要集成多个 MCP 服务器。即使您能够接受集成多个 MCP 服务器的管理开销，您的 LLM 工具调用性能也可能会受到影响，因为所有工具都会一次性加载到 LLM 的上下文窗口中。然而，统一服务器允许您动态地发现和执行ACI.dev上的任何可用功能，而不必担心数千个工具占用您的 LLM 的上下文窗口或必须集成多个 MCP 服务器。
如何指定与应用服务器一起使用的应用程序列表？您可以使用--apps参数指定与应用服务器一起使用的应用列表（以逗号分隔）。应用名称之间尽量不要有空格。
我可以只使用一个应用程序中的功能（工具）吗？是的，您只需使用--apps参数指定（一个）应用程序名称即可使用一个应用程序中的功能（工具）。

调试

您可以使用 MCP 检查器来调试服务器：

# For unified server
npx @modelcontextprotocol/inspector uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# For apps server
npx @modelcontextprotocol/inspector uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

运行tail -n 20 -f ~/Library/Logs/Claude/mcp*.log将显示来自服务器的日志，并可能帮助您调试任何问题。

AIPOLabs MCP Server

Integrations

由ACI.dev提供支持的 MCP 服务器

目录

概述

先决条件

安装

用法

应用服务器

统一服务器

了解两种服务器类型

应用服务器

统一服务器

配置

与 Claude Desktop 一起使用

与游标一起使用

常问问题

调试