由 ACI.dev 驱动的 MCP 服务器

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

目录

• 概述
• 前提条件
• 安装
• 使用
  • Apps Server
  • Unified Server
• 理解两种服务器类型
  • Apps Server
  • Unified Server
• 配置
  • 与 Claude Desktop 一起使用
  • 与 Cursor 一起使用
• 常见问题解答
• 调试

概述

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

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

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

前提条件

在使用此软件包之前，您需要（更多信息请参见 教程）：

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

安装

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

# 如果您还没有 uv，请安装它
curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

使用

Apps Server

Apps Server 提供对特定应用程序下的功能（工具）的直接访问。 您可以使用 --apps 参数指定一个或多个要使用的应用程序。（有关可用应用程序的列表，请访问 ACI.dev）

# 使用 stdio 传输（默认）
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# 使用带有自定义端口的 SSE 传输
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --transport sse --port 8000

Unified Server

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

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

# 在功能（工具）搜索/发现期间，允许发现 ACI.dev 上可用的所有功能（工具）
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# 在功能（工具）搜索/发现期间，仅限于请求代理（由 AIPOLABS_ACI_API_KEY 标识）可访问的功能（工具）
uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --allowed-apps-only

理解两种服务器类型

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

Apps Server

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

Unified Server

Unified Server 不直接公开特定于应用程序的工具。相反，它提供两个元功能（工具）：

1. ACI_SEARCH_FUNCTIONS_WITH_INTENT: 根据您的意图/需求发现功能（工具）
2. ACI_EXECUTE_FUNCTION: 执行搜索发现的任何功能（工具）

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

配置

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

与 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 一起使用

添加到您的 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 项目设置中找到它。

• 与 Apps Server 相比，使用 Unified Server 有什么好处？

  当前大多数 MCP 服务器仅限于一组特定的功能（工具），通常来自单个应用程序。 如果您需要使用来自多个应用程序的功能，则需要集成多个 MCP 服务器。 但是，即使您可以接受集成多个 MCP 服务器的管理开销，您的 LLM 工具调用性能也可能会受到影响，因为所有工具都会一次性加载到 LLM 的上下文窗口中。

  但是，Unified Server 允许您动态发现和执行 ACI.dev 上可用的任何功能，而无需担心数千个工具占用 LLM 的上下文窗口，也不必集成多个 MCP 服务器。

• 如何指定要与 Apps Server 一起使用的应用程序列表？

  您可以使用 --apps 参数指定要与 Apps Server 一起使用的逗号分隔的应用程序列表。 尽量不要在应用程序名称之间留有空格。

• 我可以只使用来自一个应用程序的功能（工具）吗？

  是的，您可以通过使用 --apps 参数指定（一个）应用程序名称来仅使用来自一个应用程序的功能（工具）。

调试

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

# 对于 Unified Server
npx @modelcontextprotocol/inspector uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# 对于 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 将显示来自服务器的日志，并可能帮助您调试任何问题。