cueapi-mcp

Offizieller Model Context Protocol-Server für CueAPI, die Open-Source-Koordinierungsebene für KI-Agentensysteme.

Geben Sie Ihrem MCP-fähigen Assistenten (Claude Desktop, Cursor, Zed oder ein anderer MCP-Host) die Möglichkeit, Agenten-Aufgaben zu planen, den Ausführungsverlauf abzurufen und den Prozess mit evidenzbasierten Ergebnisberichten abzuschließen – alles direkt aus einem Gespräch heraus.

Warum

Agenten sind nicht mit einem einzigen Aufruf fertig. Sie koordinieren sich über Zeit, Tools, Umgebungen, Agenten und Menschen hinweg. Jede Übergabe ist ein Ort, an dem sich stille Fehler verbergen. CueAPI schließt jede Übergabe mit strukturierten Nachweisen ab: eine externe ID, eine Ergebnis-URL oder ein Artefakt. Dieser MCP-Server gibt dem Agenten direkten Zugriff auf diese Oberfläche, sodass der Agent sowohl seine eigene Folgearbeit planen als auch Ergebnisse mit Nachweisen melden kann.

Related MCP server: moo-tasks

Installation

npm install -g @cueapi/mcp
# or use via npx (no install):
npx -y @cueapi/mcp

Konfiguration (Claude Desktop)

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

{
  "mcpServers": {
    "cueapi": {
      "command": "npx",
      "args": ["-y", "@cueapi/mcp"],
      "env": {
        "CUEAPI_API_KEY": "cue_sk_..."
      }
    }
  }
}

Generieren Sie Ihren API-Schlüssel unter cueapi.ai. Sie hosten selbst? Setzen Sie CUEAPI_BASE_URL zusätzlich zu CUEAPI_API_KEY.

Konfiguration (Cursor / Zed / andere Hosts)

Jeder MCP-Host, der stdio-Server unterstützt, kann dies ausführen. Verweisen Sie den Host auf die cueapi-mcp-Binärdatei und übergeben Sie CUEAPI_API_KEY in der Umgebung.

Verfügbare Tools

Beispiel-Konversation

Sie: Plane einen täglichen Job um 9 Uhr morgens, der eine Zusammenfassung an meinen Webhook sendet.

Assistent (nutzt cueapi_create_cue): Cue cue_abc123 erstellt, erste Ausführung morgen um 9:00 UTC.

Sie: Zeig mir die letzten fünf Ausführungen.

Assistent (nutzt cueapi_list_executions): ...

Entwicklung

npm install
npm test        # vitest smoke tests for the tool surface
npm run build   # compile TypeScript to dist/
npm run dev     # run the server locally with tsx

Links

• CueAPI Homepage: https://cueapi.ai

• Dokumentation: https://docs.cueapi.ai

• Core (Open Source): https://github.com/cueapi/cueapi-core

• Model Context Protocol: https://modelcontextprotocol.io

Changelog

• 0.4.1. Tool cueapi_update_cue hinzugefügt: Aktualisierung veränderbarer Cue-Felder (Name, Zeitplan, Callback-URL, Zeitzone, Payload, Beschreibung). Nutzt PATCH /v1/cues/{id}. Sparse Update – nur bereitgestellte Felder werden gesendet. Schließt die Paritätslücke zwischen den Wrappern (jeder andere Client-Wrapper bot Update-Funktionen; MCP bisher nicht).

• 0.4.0. Fünf Tools für den Ausführungs-Lebenszyklus hinzugefügt — cueapi_get_execution, cueapi_list_claimable_executions, cueapi_claim_execution, cueapi_claim_next_execution, cueapi_execution_heartbeat. Schließt die Empfangen-Beanspruchen-Verarbeiten-Abschließen-Schleife für MCP-Host-Agenten, die Worker-Transport-Ausführungen innerhalb einer Sitzung konsumieren möchten (z. B. Claude Desktop, Cursor, Zed). Highlights: list_claimable_executions filtert serverseitig über task / agent Query-Parameter (clientseitige Filterung stößt auf einen bekannten LIMIT-50-Engpass); claim_next_execution akzeptiert einen optionalen task_name und führt intern ein Fan-out durch (gefilterte Liste → wähle älteste → beanspruche per ID), da der Server noch keinen Aufgabenfilter am Basis-Claim-Endpunkt unterstützt; execution_heartbeat sendet worker_id über den X-Worker-Id Request-Header (der Transportweg des Servers für dieses Feld) und erfordert ihn im Schema, damit falsch konfigurierte Aufrufer am Wrapper scheitern, anstatt den Race-Schutz stillschweigend zu umgehen. Intern: CueAPIClient.request() erhält einen optionalen extraHeaders-Parameter zur Unterstützung von benutzerdefinierten Headern pro Aufruf.

• 0.3.0. Tool cueapi_fire_cue hinzugefügt: Löst einen bestehenden Cue sofort aus mit optionalem payload_override (und merge_strategy: 'merge' | 'replace', Standard 'merge'). Nutzt POST /v1/cues/{id}/fire. Ermöglicht Agenten das Auslösen von Ad-hoc-Einzelausführungen ohne temporäre Cues zu erstellen und lässt dynamische Daten pro Ausführung in den Webhook-Versand + Worker-Claim-Antworten fließen, ohne den gespeicherten Cue zu verändern.

• 0.1.4. Korrektur von cueapi_pause_cue / cueapi_resume_cue, um PATCH /v1/cues/{id} mit {"status": "paused" | "active"} zu verwenden (zuvor wurden nicht existierende /pause- und /resume-Endpunkte aufgerufen, was einen 404-Laufzeitfehler verursachte). PR #1. Dies ist das Release, das die Korrektur tatsächlich enthält; 0.1.3 wurde verfrüht mit diesem Hinweis, aber ohne den gemergten Code veröffentlicht.

• 0.1.3. Verfrühte Veröffentlichung, ersetzt durch 0.1.4. Keine funktionalen Änderungen gegenüber 0.1.2.

• 0.1.2. Registrierung beim offiziellen MCP-Registry.

• 0.1.0. Erstveröffentlichung: 8 Tools zum Erstellen / Auflisten / Abrufen / Pausieren / Fortsetzen / Löschen von Cues, Auflisten von Ausführungen, Melden von Ergebnissen.

Lizenz

MIT © Vector Apps Inc.