MCP servers powered by

ACI.dev を利用した MCP サーバー

重要

この README では、基本的な開発ガイドのみを説明しています。ACI.dev MCP サーバーの詳細なドキュメントとチュートリアルについては、aci.dev docs をご覧ください。

目次

• ACI.dev を利用した MCP サーバー
  • 目次
  • 概要
  • MCP サーバーをローカルで実行する
  • MCP クライアントとの連携
  • Docker
  • デバッグ

概要

このパッケージは、ACI.dev が管理する関数（ツール）にアクセスするための、3 つの Model Context Protocol（MCP）サーバーを提供します。

• aci-mcp-apps：指定したアプリの関数（ツール）に直接アクセスできる MCP サーバーです。
• aci-mcp-unified：ACI.dev で利用可能なすべての関数（ツール）を検索・実行するための 2 つのメタ関数（ツール）（ACI_SEARCH_FUNCTIONS と ACI_EXECUTE_FUNCTION）を提供する MCP サーバーです。

重要

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 サーバーを設定する方法については、統合 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 を実行すると、サーバーのログが表示され、問題のデバッグに役立つ場合があります。