[!重要] このREADMEは基本的な開発ガイドのみをカバーしています。MCPサーバーに関する完全なドキュメントやチュートリアルについては ACI.dev ドキュメント aci.dev ご覧ください。

目次

• ACI.dev で駆動されるMCPサーバー
• 目次
• 概要
• MCPサーバーをローカルで運用する
• MCPクライアントとの統合
• Docker
• デバッグ

概要

このパッケージは、管理機能(ツール)にアクセスするための3つのモデルコンテキストプロトコル(MCP)サーバー ACI.dev 提供します。

• aci-mcp-apps:指定されたアプリから機能(ツール)に直接アクセスできるMCPサーバー

• aci-mcp-unified:MCPサーバーで、2つのメタ関数(ツール)(ACI_SEARCH_FUNCTIONSとACI_EXECUTE_FUNCTION)を提供し、利用可能なすべての関数(ツール)を発見・実行する ACI.dev

[!重要] MCPサーバーの詳細な説明やチュートリアルについては、aci.dev ドキュメントをご覧ください。

MCPサーバーをローカルで運用

パッケージはPyPIに公開されているので、uvxを使って直接実行できます:

MCPクライアントとの統合

異なるMCPクライアントでMCPサーバーを設定する方法については、「統合MCPサーバー」および「Apps MCPサーバー」セクションをご覧ください。

Docker

デバッグ

MCP servers powered by ACI.dev

[!IMPORTANT] This README only covers basic development guide. For full documentation and tutorials on ACI.dev MCP servers please visit aci.dev docs.

Table of Contents

• MCP servers powered by ACI.dev
  • Table of Contents
  • Overview
  • Run MCP Servers Locally
  • Integration with MCP Clients
  • Docker
  • Debugging

Overview

This package provides three Model Context Protocol (MCP) servers for accessing ACI.dev managed functions (tools):

• aci-mcp-apps: An MCP server that provides direct access to functions (tools) from specified apps

• aci-mcp-unified: An MCP server that provides two meta functions (tools) (ACI_SEARCH_FUNCTIONS and ACI_EXECUTE_FUNCTION) to discover and execute ALL functions (tools) available on ACI.dev

[!IMPORTANT] For detailed explanation and tutorials on the MCP servers please visit aci.dev docs.

Run MCP Servers Locally

The package is published to PyPI, so you can run it directly using 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.

Integration with MCP Clients

See the Unified MCP Server and Apps MCP Server sections for more information on how to configure the MCP servers with different MCP clients.

Docker

# Build the image
docker build -t aci-mcp .

# Run the unified server
docker run --rm -i -e ACI_API_KEY= aci-mcp unified-server --linked-account-owner-id 

# Run the apps server
docker run --rm -i -e ACI_API_KEY= aci-mcp apps-server --apps  --linked-account-owner-id 

Debugging

You can use the MCP inspector to debug the server:

# For unified server
npx @modelcontextprotocol/inspector uvx aci-mcp unified-server --linked-account-owner-id 

# For apps server