Skip to main content
Glama
Sign In
enesjakozh

AIPOLabs MCP Server

by aipotheosis-labs
Verified
GitHub
Python
MIT License
21
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides search functionality through the BRAVE_SEARCH tool, allowing agents to perform web searches using Brave's search engine

  • Enables interaction with Gmail accounts, giving agents the ability to work with email content and functionality

Servidores MCP con tecnología ACI.dev

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

Tabla de contenido

Descripción general

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

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

  • aipolabs-mcp-apps : un servidor MCP que proporciona acceso directo a funciones (herramientas) desde aplicaciones específicas
  • aipolabs-mcp-unified : un servidor MCP que proporciona dos metafunciones (herramientas) ( ACI_SEARCH_FUNCTIONS_WITH_INTENT y ACI_EXECUTE_FUNCTION ) para descubrir y ejecutar TODAS las funciones (herramientas) disponibles en ACI.dev

Prerrequisitos

Antes de utilizar este paquete, necesita (para obtener más información, consulte el tutorial ):

  1. Establezca la variable de entorno AIPOLABS_ACI_API_KEY con su clave API ACI.dev
  2. Configure aplicaciones y configúrelas en allowed_apps para su agente en platform.aci.dev .
  3. Vincula las cuentas específicas de tu aplicación bajo el mismo --linked-account-owner-id que proporcionarás más adelante para iniciar los servidores MCP

Instalación

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

Uso

Servidor de aplicaciones

El servidor de aplicaciones proporciona acceso directo a las funciones (herramientas) de aplicaciones específicas. Puede especificar una o más aplicaciones con el parámetro --apps . (Para ver la lista de aplicaciones disponibles, visite ACI.dev ).

# Using stdio transport (default) uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> # Using SSE transport with custom port uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --transport sse --port 8000

Servidor unificado

El servidor unificado proporciona dos metafunciones (herramientas) para descubrir y ejecutar CUALQUIER función (herramienta) disponible en ACI.dev , incluso si no están enumeradas directamente en el servidor.

Las funciones (herramientas) se buscan y ejecutan dinámicamente según sus necesidades. No tendrá que preocuparse por tener miles de herramientas ocupando la ventana contextual de su LLM ni por tener que integrar varios servidores MCP.

# During functions (tools) search/discovery, allow discoverability of all functions (tools) available on ACI.dev uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> # During functions (tools) search/discovery, limit to only functions (tools) accessible by the requesting agent (identified by AIPOLABS_ACI_API_KEY) uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> --allowed-apps-only

Comprensión de los dos tipos de servidores

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

Servidor de aplicaciones

El servidor de aplicaciones proporciona acceso directo a funciones/herramientas específicas de la aplicación que especifique con el parámetro --apps . Estas herramientas aparecerán directamente en la lista de herramientas cuando los clientes MCP (p. ej., Claude Desktop, Cursor, etc.) interactúen con este servidor.

Servidor unificado

El servidor unificado no expone directamente herramientas específicas de la aplicación. En su lugar, proporciona dos metafunciones (herramientas):

  1. ACI_SEARCH_FUNCTIONS_WITH_INTENT : descubre funciones (herramientas) según su intención/necesidades
  2. ACI_EXECUTE_FUNCTION : ejecuta CUALQUIER función (herramienta) descubierta por la búsqueda

Este enfoque permite a los clientes de MCP descubrir y usar dinámicamente cualquier función disponible en la plataforma ACI.dev sin necesidad de listarlas todas previamente. Puede buscar la herramienta adecuada según sus necesidades y ejecutarla.

Configuración

Para obtener documentación completa y tutoriales sobre servidores MCP, visita aci.dev docs .

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{ "mcpServers": { "aipolabs-mcp-unified": { "command": "uvx", "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"] } } }

Para acceso específico a aplicaciones:

{ "mcpServers": { "aipolabs-mcp-apps": { "command": "uvx", "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"] } } }

Uso con cursor

Añade a tu Cursor mcp.json :

{ "mcpServers": { "aipolabs-mcp-unified": { "command": "uvx", "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"], "env": { "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>" } } } }

Para acceso específico a aplicaciones:

{ "mcpServers": { "aipolabs-mcp-apps": { "command": "uvx", "args": ["aipolabs-mcp", "apps-server", "--apps", "BRAVE_SEARCH,GMAIL", "--linked-account-owner-id", "<LINKED_ACCOUNT_OWNER_ID>"], "env": { "AIPOLABS_ACI_API_KEY": "<AIPOLABS_ACI_API_KEY>" } } } }

Preguntas frecuentes

  • ¿Cómo obtengo la AIPOLABS_ACI_API_KEY ?AIPOLABS_ACI_API_KEY es la clave API de tu proyecto ACI.dev . Puedes encontrarla en la configuración del proyecto ACI.dev .
  • ¿Cómo configurar Apps y permitir el acceso a ellas?Puede configurar aplicaciones y permitir el acceso a ellas en la configuración del proyecto ACI.dev .
  • ¿Cómo obtengo el LINKED_ACCOUNT_OWNER_ID ?El ID de la cuenta LINKED_ACCOUNT_OWNER_ID es el ID de la cuenta que desea usar para acceder a las funciones. Puede encontrarlo en la configuración del proyecto ACI.dev .
  • ¿Cuál es el beneficio de utilizar el servidor unificado en lugar del servidor de aplicaciones?La mayoría de los servidores MCP actuales se limitan a un conjunto específico de funciones (herramientas), generalmente de una sola aplicación. Si necesita usar funciones de varias aplicaciones, deberá integrar varios servidores MCP. Sin embargo, incluso si acepta la sobrecarga de gestión que supone integrar varios servidores MCP, el rendimiento de las llamadas a herramientas LLM podría verse afectado, ya que todas las herramientas se cargan simultáneamente en la ventana de contexto de LLM.Sin embargo, el servidor unificado le permite descubrir y ejecutar CUALQUIER función disponible en ACI.dev de forma dinámica sin preocuparse por tener miles de herramientas ocupando la ventana de contexto de su LLM o tener que integrar múltiples servidores MCP.
  • ¿Cómo especificar una lista de aplicaciones para usar con el servidor de aplicaciones?Puedes especificar una lista de aplicaciones separadas por comas para usar con el servidor de aplicaciones mediante el parámetro --apps . Intenta evitar espacios entre los nombres de las aplicaciones.
  • ¿Puedo usar funciones (herramientas) solo de una aplicación?Sí, puedes usar funciones (herramientas) de una aplicación especificando el nombre de la (única) aplicación con el parámetro --apps .

Depuración

Puede utilizar el inspector MCP para depurar el servidor:

# For unified server npx @modelcontextprotocol/inspector uvx aipolabs-mcp unified-server --linked-account-owner-id <LINKED_ACCOUNT_OWNER_ID> # For apps server npx @modelcontextprotocol/inspector uvx aipolabs-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.

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de protocolo de contexto de modelo que proporciona acceso a las funciones (herramientas) de ACI.dev a través de herramientas directas específicas de la aplicación o una interfaz unificada con descubrimiento y ejecución de herramientas dinámicas según la intención del usuario.

  1. Table of Contents
    1. Overview
      1. Prerequisites
        1. Installation
          1. Usage
            1. Apps Server
            2. Unified Server
          2. Understanding the Two Server Types
            1. Apps Server
            2. Unified Server
          3. Configuration
            1. Usage with Claude Desktop
            2. Usage with Cursor
          4. FAQ
            1. Debugging
              ID: o6gen4gnh6