使用说明

项目简介

ACI MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 客户端提供访问 ACI.dev 平台功能的桥梁。它允许 LLM 通过标准化的 MCP 协议调用 ACI.dev 上的工具（Functions），从而扩展 LLM 的能力。该项目提供两种服务器类型：

Apps Server: 允许访问特定应用的工具。
Unified Server: 提供元工具，可以动态搜索和执行 ACI.dev 平台上的所有工具。

主要功能点

工具 (Tools) 访问: 通过 MCP 协议向 LLM 客户端暴露 ACI.dev 平台上的功能作为工具。
两种服务器模式:
- Apps Server: 直接列出指定应用的工具，简单直接。
- Unified Server: 提供动态工具发现和执行能力，无需预先列出所有工具，节省 LLM 上下文空间。
多种传输协议: 支持 Stdio 和 SSE 传输协议。
易于集成: 提供与 Claude Desktop 和 Cursor 等 MCP 客户端的集成配置示例。

安装步骤

安装 'uv': 如果尚未安装 'uv'，请运行以下命令安装：

curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

服务器配置

MCP 客户端（如 Claude Desktop, Cursor）需要配置 MCP 服务器的启动信息才能连接。以下是针对不同服务器类型和客户端的配置示例。你需要将 '<LINKED_ACCOUNT_OWNER_ID>' 和 '<ACI_API_KEY>' 替换为你在 ACI.dev 平台上的实际值。

1. Claude Desktop 配置 ( 'claude_desktop_config.json' )

Unified Server:

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

参数说明:

'command': 启动服务器的命令，这里使用 'uvx' 运行 'aci-mcp' 包。
'args': 传递给 'aci-mcp unified-server' 命令的参数。
- '--linked-account-owner-id': 必需参数，你的 ACI.dev 账户 ID，用于访问关联账户的工具。

Apps Server:

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

参数说明:

'command': 启动服务器的命令。
'args': 传递给 'aci-mcp apps-server' 命令的参数。
- '--apps': 必需参数，指定要访问的应用列表，用逗号分隔，例如 "BRAVE_SEARCH,GMAIL"。
- '--linked-account-owner-id': 必需参数，你的 ACI.dev 账户 ID。

2. Cursor 配置 ( 'mcp.json' )

Unified Server:

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

参数说明:

'command': 启动服务器的命令。
'args': 传递给 'aci-mcp unified-server' 命令的参数，与 Claude Desktop 相同。
'env': 环境变量配置。
- 'ACI_API_KEY': 必需参数，你的 ACI.dev API 密钥。

Apps Server:

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

参数说明:

'command': 启动服务器的命令。
'args': 传递给 'aci-mcp apps-server' 命令的参数，与 Claude Desktop 相同。
'env': 环境变量配置。
- 'ACI_API_KEY': 必需参数，你的 ACI.dev API 密钥。

基本使用方法

配置环境变量: 确保 'ACI_API_KEY' 环境变量已设置，或者在 Cursor 的 'mcp.json' 配置文件中配置。

运行 MCP 服务器: 根据你的需求选择 Apps Server 或 Unified Server，使用 'uvx' 命令启动服务器。例如，启动 Unified Server (stdio 传输):

uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

配置 MCP 客户端: 将上述相应的 JSON 配置添加到你的 MCP 客户端配置文件中 (如 Claude Desktop 的 'claude_desktop_config.json' 或 Cursor 的 'mcp.json')。
在 LLM 中使用工具: 在支持 MCP 协议的 LLM 客户端中，你应该能够看到并使用来自 ACI.dev 的工具了。

注意: 请务必访问 ACI.dev 平台配置你的 API 密钥、应用和关联账户，以便服务器能够正常访问 ACI.dev 的功能。

关键词

使用说明

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息