Servidores MCP con tecnología ACI.dev

[!IMPORTANTE] Este archivo README solo cubre la guía básica de desarrollo. Para obtener la documentación completa y los tutoriales sobre los servidores MCP de ACI.dev, visite la documentación de aci.dev .

Tabla de contenido

• Descripción general

• Ejecutar servidores MCP localmente

• Integración con clientes MCP

• Estibador

• Depuración

Related MCP server: MCP Toolkit

Descripción general

Este paquete proporciona dos servidores de Protocolo de contexto de modelo (MCP) para acceder a las funciones administradas (herramientas) de ACI.dev :

• aci-mcp-apps : un servidor MCP que proporciona acceso directo a funciones (herramientas) desde aplicaciones específicas

• aci-mcp-unified : un servidor MCP que proporciona dos metafunciones (herramientas) ( ACI_SEARCH_FUNCTIONS y ACI_EXECUTE_FUNCTION ) para descubrir y ejecutar TODAS las funciones (herramientas) disponibles en ACI.dev

[!IMPORTANTE] Para obtener una explicación detallada y tutoriales sobre los dos servidores MCP, visita aci.dev docs .

Ejecutar servidores MCP localmente

El paquete se publica en PyPI, por lo que puedes ejecutarlo directamente usando 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.

Integración con clientes MCP

Consulte las secciones Servidor MCP unificado y Servidor MCP de aplicaciones para obtener más información sobre cómo configurar los servidores MCP con diferentes clientes MCP.

Estibador

# 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>

Depuración

Puede utilizar el inspector MCP para depurar el servidor:

# 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>

Ejecutar tail -n 20 -f ~/Library/Logs/Claude/mcp*.log mostrará los registros del servidor y puede ayudarlo a depurar cualquier problema.