Didlogic MCP Server

Servidor MCP de Didlogic

Una implementación de servidor del Model Context Protocol (MCP) para la API de Didlogic. Este servidor permite que los Modelos de Lenguaje de Gran Tamaño (LLMs) interactúen con los servicios de Didlogic a través de una interfaz estandarizada.

Características

• Acceso completo a la API de Didlogic a través de herramientas MCP
• Prompts especializados para operaciones comunes
• Herramientas de gestión de saldo
• Gestión de cuentas SIP (sipfriends)
• Gestión de restricciones de IP
• Gestión de compras
• Acceso al historial de llamadas
• Acceso al historial de transacciones

Instalación

Usando uv (recomendado)

Cuando se usa uv no se necesita una instalación específica. Usaremos uvx para ejecutar directamente didlogic_mcp.

Usando PIP

Alternativamente, puedes instalar didlogic_mcp vía pip:

pip install didlogic_mcp

Después de la instalación, puedes ejecutarlo como un script usando:

DIDLOGIC_API_KEY=YOUR_DIDLOGIC_KEY python -m didlogic_mcp

Modos de Transporte

El servidor soporta tres modos de transporte:

Modo STDIO (Predeterminado)

Para integración local con Claude Desktop o herramientas similares. Usa la variable de entorno DIDLOGIC_API_KEY para la autenticación.

# Using uvx (recommended)
DIDLOGIC_API_KEY=your_key uvx didlogic_mcp

# Using uv run
DIDLOGIC_API_KEY=your_key uv run didlogic_mcp

# As Python module
DIDLOGIC_API_KEY=your_key python -m didlogic_mcp --transport stdio

Modo HTTP

Para acceso remoto y clientes web. Requiere un token Bearer en el encabezado Authorization para cada solicitud.

# Using default port (8000)
python -m didlogic_mcp --transport http

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport http

# Custom host and port
python -m didlogic_mcp --transport http --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport http --log-level DEBUG

Variables de Entorno:

• PORT - Puerto del servidor (predeterminado: 8000)
• DIDLOGIC_API_URL - URL base de la API de Didlogic (predeterminado: https://app.didlogic.com/api)

Nota: En modo HTTP, los clientes deben proporcionar su clave de API como un token Bearer en el encabezado Authorization.

Modo SSE (Eventos Enviados por el Servidor)

Para comunicación en streaming con conexiones persistentes. Ideal para actualizaciones en tiempo real y escenarios de streaming. Requiere un token Bearer en el encabezado Authorization para cada solicitud.

# Using default port (8000)
python -m didlogic_mcp --transport sse

# Custom port via environment variable
PORT=9000 python -m didlogic_mcp --transport sse

# Custom host and port
python -m didlogic_mcp --transport sse --host 0.0.0.0 --port 9000

# With debug logging
python -m didlogic_mcp --transport sse --log-level DEBUG

Variables de Entorno:

• PORT - Puerto del servidor (predeterminado: 8000)
• DIDLOGIC_API_URL - URL base de la API de Didlogic (predeterminado: https://app.didlogic.com/api)

Nota: En modo SSE, los clientes deben proporcionar su clave de API como un token Bearer en el encabezado Authorization para conexiones de streaming persistentes.

Configuración

Configurar para Claude.app

Añade a tu configuración de Claude:

Usando uvx

"mcpServers": {
  "didlogic": {
    "command": "uvx",
    "args": ["didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Usando instalación con pip

"mcpServers": {
  "didlogic": {
    "command": "python",
    "args": ["-m", "didlogic_mcp"],
    "env": {
      "DIDLOGIC_API_KEY": "YOUR_DIDLOGIC_KEY"
    }
  }
}

Configurar para Claude Code

Para Claude Code, puedes conectarte a una instancia de servidor SSE en ejecución:

claude mcp add didlogic --transport sse http://localhost:8000/sse --header "Authorization: Bearer YOUR_DIDLOGIC_API_KEY"

Requisitos previos:

1. Inicia el servidor en modo SSE: python -m didlogic_mcp --transport sse
2. Ejecuta el comando anterior, reemplazando YOUR_DIDLOGIC_API_KEY con tu clave de API real
3. El servidor debe estar en ejecución y ser accesible en la URL especificada

Configuración personalizada:

• Para usar un puerto diferente: Cambia http://localhost:8000/sse para que coincida con la configuración de PUERTO de tu servidor
• Para conectarte a un servidor remoto: Reemplaza localhost con el nombre de host o dirección IP del servidor

Licencia

MIT