[! 중요] 이 README는 기본 개발 가이드만 다룹니다. ACI.dev MCP 서버에 대한 전체 문서와 튜토리얼은 aci.dev 문서를 방문해 주세요.

목차

• ACI.dev 구동 MCP 서버
• 목차
• 개요
• MCP 서버를 로컬에서 실행
• MCP 클라이언트와의 통합
• 도커
• 디버깅

개요

이 패키지는 ACI.dev 관리 기능(도구)에 접근하기 위한 세 개의 모델 컨텍스트 프로토콜(MCP) 서버를 제공합니다:

• aci-mcp-apps: 지정된 앱에서 기능(도구)에 직접 접근을 제공하는 MCP 서버입니다

• aci-mcp-unified: 두 개의 메타 함수(도구)(ACI_SEARCH_FUNCTIONS와 ACI_EXECUTE_FUNCTION)를 제공하여 ACI.dev 에서 이용 가능한 ALL 기능(도구)을 발견하고 실행하는 MCP 서버입니다

[! 중요] MCP 서버에 대한 자세한 설명과 튜토리얼은 aci.dev 문서를 방문해 주세요.

MCP 서버를 로컬에서 실행하세요

패키지는 PyPI에 배포되므로 uvx를 사용해 직접 실행할 수 있습니다:

MCP 클라이언트와의 통합

다양한 MCP 클라이언트로 MCP 서버를 구성하는 방법에 대한 자세한 내용은 통합 MCP 서버 및 Apps MCP 서버 섹션을 참조하세요.

도커

디버깅

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