JinDaGe - aci-mcp MCP Details

article

README

🚀 使用ACI.dev的MCP服务器开发指南

本指南将为你介绍如何使用ACI.dev的MCP服务器进行开发，帮助你快速上手并了解相关操作。如果你需要完整的文档和教程，请访问aci.dev官方文档。

🚀 快速开始

概述

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

aci-mcp-apps：一个MCP服务器，提供对指定应用中功能的直接访问权限。
aci-mcp-unified：一个MCP服务器，提供两个元功能（工具） (ACI_SEARCH_FUNCTIONS和ACI_EXECUTE_FUNCTION) 来发现和执行所有在ACI.dev上可用的功能（工具）。

⚠️ 重要提示

有关两个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 [OPTIONS] COMMAND [ARGS]...

  包的主入口点。

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

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

与MCP客户端集成

请参阅统一MCP服务器和apps 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>

# 运行apps服务器
docker run --rm -i -e ACI_API_KEY=<ACI_API_KEY> aci-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

调试

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

# 对于统一服务器
npx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID>

# 对于apps服务器
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将显示服务器日志，可能有助于排查问题。

aci-mcp