@invariance/mcp

Ein MCP-Server (Model Context Protocol), der KI-Coding-Agenten mit der Invariance-Observability-Plattform verbindet. Er bietet Tools wie Claude Desktop, Cursor und Claude Code direkten Zugriff auf Ihre Runs, Nodes, Monitore, Signale, Findings, Reviews und mehr.

MCP ist ein offenes Protokoll, das es KI-Assistenten ermöglicht, externe Tools und Datenquellen zu nutzen. Dieser Server implementiert es für Invariance, sodass Ihr KI-Assistent Observability-Daten abfragen, Probleme untersuchen und das Verhalten von Agenten analysieren kann, ohne das Gespräch zu verlassen.

Installation

npm install -g @invariance/mcp

Oder führen Sie es direkt mit npx aus (empfohlen für MCP-Client-Konfigurationen):

npx @invariance/mcp

Related MCP server: Claude Code Starter Kit MCP

Einrichtung

Umgebungsvariablen

Sie erhalten Ihren API-Schlüssel unter app.invariance.ai/settings/api-keys.

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS):

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

Claude Code

Fügen Sie dies zu Ihrer Claude Code-Konfiguration hinzu (.claude/settings.json oder ~/.claude/settings.json):

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

Cursor

Fügen Sie dies zu Ihren Cursor MCP-Einstellungen hinzu (.cursor/mcp.json):

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

Verfügbare Tools

Der Server stellt 37 Tools bereit, die die vollständige Invariance-API abdecken. Die Namen folgen dem Schema invariance_<resource>_<action>.

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

Nodes (invariance_node_*) write, list

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

Signale (invariance_signal_*) emit, list, get, acknowledge, resolve

Findings (invariance_finding_*) list, get, update

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

Agenten (invariance_agent_*) me, set_key

Insights invariance_narrative_get (LLM-synthetisierte Run-Zusammenfassung), invariance_ask (turn-basierte Q&A über Ihre KB + Runs), invariance_kb_pages_list, invariance_kb_page_get

Für komplexe Objektargumente (Monitor-Body, Signaldaten, Node-Input/Output, Run-Metadaten) akzeptieren die Tools JSON-kodierte Strings, die der Server vor der Weiterleitung an die API parst.

Legacy-Tool-Aliase

Die ursprünglichen 6 Tool-Namen aus früheren Versionen bleiben als Aliase erhalten, damit bestehende Client-Konfigurationen weiterhin funktionieren: invariance_create_run, invariance_get_run, invariance_list_runs, invariance_write_node, invariance_list_nodes, invariance_verify_run.

HTTP-Transport

Um den Server über Streamable HTTP anstelle von stdio auszuführen:

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

Der Server stellt einen Streamable HTTP-Endpunkt unter http://127.0.0.1:3000/mcp und einen Health-Check unter http://127.0.0.1:3000/health bereit.

MCP-Clients, die HTTP-Transport unterstützen, können sich über die /mcp-Endpunkt-URL verbinden, anstatt einen Subprozess zu starten.

Fehlerbehebung

"INVARIANCE_API_KEY environment variable is required"

Stellen Sie sicher, dass Sie die Umgebungsvariable INVARIANCE_API_KEY in Ihrer MCP-Client-Konfiguration gesetzt haben. Siehe die Einrichtungsanleitungen oben.

Server erscheint nicht in Ihrem MCP-Client

1. Überprüfen Sie, ob der Pfad zur Konfigurationsdatei für Ihren Client korrekt ist

2. Starten Sie den Client nach dem Bearbeiten der Konfiguration neu

3. Überprüfen Sie, ob npx @invariance/mcp in Ihrem Terminal ohne Fehler ausgeführt wird

Authentifizierungsfehler

Überprüfen Sie, ob Ihr API-Schlüssel unter app.invariance.ai/settings/api-keys gültig ist.

Verbindungs-Timeouts

Wenn Sie eine benutzerdefinierte INVARIANCE_BASE_URL verwenden, überprüfen Sie, ob die URL erreichbar ist.

Mitwirken

Siehe CONTRIBUTING.md.

Lizenz

MIT