Aci MCP

🚀 使用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將顯示服務器日誌，可能有助於排查問題。