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

[!IMPORTANT] 本 README 只涵盖了基本的开发指南。有关 ACI.dev MCP 服务器的完整文档和教程，请访问 ACI.dev 文档。

目录

• 由 ACI.dev 提供支持的 MCP 服务器
  • 目录
  • 概述
  • 本地运行 MCP 服务器
  • 与 MCP 客户端集成
  • Docker
  • 调试

概述

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

• aci-mcp-apps：一个 MCP 服务器，提供对指定应用中的功能（工具）的直接访问 <img src="./assets/apps-mcp-server-diagram.svg" alt="Apps Server"/>
• aci-mcp-unified：一个 MCP 服务器，提供两个元功能（工具）（ACI_SEARCH_FUNCTIONS 和 ACI_EXECUTE_FUNCTION），以发现并执行 ACI.dev 上的所有可用功能（工具） <img src="./assets/unified-mcp-server-diagram.svg" alt="Unified Server">

[!IMPORTANT] 有关 MCP 服务器的详细解释和教程，请访问 ACI.dev 文档。

本地运行 MCP 服务器

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

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

$ uvx aci-mcp --help
用法：aci-mcp [选项] 命令 [参数]...

  包的主要入口点。

选项：
  --help  显示此消息并退出。

命令：
  apps-server     启动特定于应用的 MCP 服务器以访问工具...
  unified-server  启动具有无限工具访问权限的统一 MCP 服务器。

与 MCP 客户端集成

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

Docker

# 构建镜像
docker build -t aci-mcp .

# 运行统一服务器
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# 运行应用服务器
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mc