@invariance/mcp

Un servidor MCP (Model Context Protocol) que conecta agentes de codificación de IA a la plataforma de observabilidad Invariance. Proporciona a herramientas como Claude Desktop, Cursor y Claude Code acceso directo a tus ejecuciones, nodos, monitores, señales, hallazgos, revisiones y más.

MCP es un protocolo abierto que permite a los asistentes de IA utilizar herramientas y fuentes de datos externas. Este servidor lo implementa para Invariance, de modo que tu asistente de IA pueda consultar datos de observabilidad, investigar problemas y analizar el comportamiento del agente sin abandonar la conversación.

Instalación

npm install -g @invariance/mcp

O ejecútalo directamente con npx (recomendado para configuraciones de cliente MCP):

npx @invariance/mcp

Related MCP server: Claude Code Starter Kit MCP

Configuración

Variables de entorno

Obtén tu clave de API en app.invariance.ai/settings/api-keys.

Claude Desktop

Añádelo a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "invariance": {
      "command": "npx",
      "args": ["-y", "@invariance/mcp"],
      "env": {
        "INVARIANCE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Añádelo a tu configuración de Claude Code (.claude/settings.json o ~/.claude/settings.json):

{
  "mcpServers": {
    "invariance": {
      "command": "npx",
      "args": ["-y", "@invariance/mcp"],
      "env": {
        "INVARIANCE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Añádelo a tu configuración de MCP de Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "invariance": {
      "command": "npx",
      "args": ["-y", "@invariance/mcp"],
      "env": {
        "INVARIANCE_API_KEY": "your-api-key"
      }
    }
  }
}

Herramientas disponibles

El servidor expone 37 herramientas que cubren toda la API de Invariance. Los nombres siguen el formato invariance_<recurso>_<acción>.

Ejecuciones (Runs) (invariance_run_*) start, get, list, finish, fail, verify, metrics

Nodos (Nodes) (invariance_node_*) write, list

Monitores (Monitors) (invariance_monitor_*) create, list, get, update, pause, resume, evaluate, executions, findings

Señales (Signals) (invariance_signal_*) emit, list, get, acknowledge, resolve

Hallazgos (Findings) (invariance_finding_*) list, get, update

Revisiones (Reviews) (invariance_review_*) list, get, claim, unclaim, resolve

Agentes (Agents) (invariance_agent_*) me, set_key

Perspectivas (Insights) invariance_narrative_get (resumen de ejecución sintetizado por LLM), invariance_ask (preguntas y respuestas basadas en turnos sobre tu KB + ejecuciones), invariance_kb_pages_list, invariance_kb_page_get

Para argumentos de objetos complejos (cuerpo del monitor, datos de señal, entrada/salida de nodo, metadatos de ejecución), las herramientas aceptan cadenas codificadas en JSON, que el servidor analiza antes de enviarlas a la API.

Alias de herramientas heredadas

Los 6 nombres de herramientas originales de versiones anteriores se mantienen como alias para que las configuraciones de cliente existentes sigan funcionando: invariance_create_run, invariance_get_run, invariance_list_runs, invariance_write_node, invariance_list_nodes, invariance_verify_run.

Transporte HTTP

Para ejecutar el servidor sobre HTTP transmitible (Streamable) en lugar de stdio:

INVARIANCE_API_KEY=your-api-key INVARIANCE_MCP_TRANSPORT=http INVARIANCE_MCP_PORT=3000 npx @invariance/mcp

El servidor expone un endpoint HTTP transmitible en http://127.0.0.1:3000/mcp y una comprobación de estado en http://127.0.0.1:3000/health.

Los clientes MCP que admiten transporte HTTP pueden conectarse utilizando la URL del endpoint /mcp en lugar de generar un subproceso.

Solución de problemas

"INVARIANCE_API_KEY environment variable is required"

Asegúrate de haber configurado la variable de entorno INVARIANCE_API_KEY en la configuración de tu cliente MCP. Consulta las guías de configuración anteriores.

El servidor no aparece en tu cliente MCP

1. Verifica que la ruta del archivo de configuración sea correcta para tu cliente

2. Reinicia el cliente después de editar la configuración

3. Comprueba que npx @invariance/mcp se ejecute sin errores en tu terminal

Errores de autenticación

Verifica que tu clave de API sea válida en app.invariance.ai/settings/api-keys.

Tiempos de espera de conexión (Timeouts)

Si utilizas una INVARIANCE_BASE_URL personalizada, verifica que la URL sea accesible.

Contribución

Consulta CONTRIBUTING.md.

Licencia

MIT