ACI.dev搭載の MCP サーバー
IMPORTANT
このREADMEは基本的な開発ガイドのみを扱っています。ACI.dev MCPサーバーに関する完全なドキュメントとチュートリアルについては、aci.dev docsをご覧ください。
目次
Related MCP server: Agent Construct
概要
このパッケージは、 ACI.devが管理する関数 (ツール) にアクセスするための 2 つの Model Context Protocol (MCP) サーバーを提供します。
aci-mcp-apps: 指定されたアプリから機能（ツール）への直接アクセスを提供する MCP サーバーaci-mcp-unified: ACI.devで利用可能なすべての関数 (ツール) を検出して実行するための 2 つのメタ関数 (ツール) (ACI_SEARCH_FUNCTIONSとACI_EXECUTE_FUNCTION) を提供する MCP サーバー
IMPORTANT
2 つの MCP サーバーの詳細な説明とチュートリアルについては、aci.dev docsをご覧ください。
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 サーバーを構成する方法の詳細については、 「Unified MCP サーバー」および「Apps MCP サーバー」のセクションを参照してください。
ドッカー
# 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を実行すると、サーバーのログが表示され、問題のデバッグに役立つ場合があります。