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

重要提示：本 README 仅涵盖基本开发指南。如需 ACI.dev MCP 服务器的完整文档和教程，请访问aci.dev docs 。

概述

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

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

IMPORTANT

有关这两个 MCP 服务器的详细说明和教程，请访问aci.dev 文档。

本地运行 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

$ uvx aci-mcp --help
Usage: aci-mcp [OPTIONS] COMMAND [ARGS]...

  Main entry point for the package.

Options:
  --help  Show this message and exit.

Commands:
  apps-server     Start the apps-specific MCP server to access tools...
  unified-server  Start the unified MCP server with unlimited tool access.

与 MCP 客户端集成

有关如何使用不同的 MCP 客户端配置 MCP 服务器的更多信息，请参阅统一 MCP 服务器和应用程序 MCP 服务器部分。

Docker

# Build the image
docker build -t aci-mcp .

# Run the unified server
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# Run the apps server
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp apps-server --apps <APP1,APP2,...> --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

调试

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

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

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

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