damonzucconi-mcp

Remote-MCP-Server zur Verwaltung von damonzucconi.com über seine GraphQL-API.

Produktionsendpunkt: https://damonzucconi-mcp.damonzucconi.workers.dev/mcp

Der Server ist ein zustandsloser Cloudflare Worker ohne Speicherbindungen. Ein statisches Bearer-Token schützt den MCP-Endpunkt. Der Worker meldet sich mit den vorhandenen Admin-Anmeldedaten bei der GraphQL-API an und zwischenspeichert das resultierende JWT bis kurz vor Ablauf.

Es stellt Werkzeuge für Kunstwerke, Ausstellungen, Tags, verschachtelte Entitäten und Sortierung bereit. Das Löschen von Kunstwerken und Ausstellungen ist absichtlich nicht verfügbar; führen Sie diese manuell durch.

Lokale Entwicklung

Erfordert Node.js 20+ und npm.

npm install
cp .dev.vars.example .dev.vars

Legen Sie die drei Geheimnisse in .dev.vars fest:

openssl rand -hex 32

MCP_AUTH_TOKEN=<paste-generated-value>
ADMIN_USERNAME=your-api-admin-username
ADMIN_PASSWORD=your-api-admin-password

MCP_AUTH_TOKEN ist ein gemeinsames Geheimnis, kein Benutzername oder Anmeldetoken. Der Worker speichert eine Kopie und jeder MCP-Client sendet denselben Wert als Bearer-Token. Der Besitz dieses Werts gewährt Zugriff auf den Server.

Es gibt keine automatische Synchronisierung:

• .dev.vars versorgt den lokalen Worker und ist die Quelle, die von npm run secrets:push verwendet wird.

• npm run secrets:push kopiert den Wert in Cloudflares verschlüsselte Worker-Secrets für die Produktion.

• Cursor und ChatGPT lesen denselben Wert aus der clientseitigen Umgebungsvariable DAMONZUCCONI_MCP_TOKEN.

Wenn Sie MCP_AUTH_TOKEN ändern, führen Sie npm run secrets:push aus, aktualisieren Sie DAMONZUCCONI_MCP_TOKEN und starten Sie den Client neu. Ein Client, der einen anderen Wert verwendet, erhält 401 Unauthorized.

npm run codegen
npm run typecheck
npm run dev

Der lokale MCP-Endpunkt ist http://127.0.0.1:8787/mcp. In einem anderen Terminal:

npm run smoke

Um stattdessen die Produktion zu testen:

MCP_URL=https://damonzucconi-mcp.damonzucconi.workers.dev npm run smoke

Verbindung von Cursor

Fügen Sie dies zu .cursor/mcp.json für dieses Projekt oder global zu ~/.cursor/mcp.json hinzu:

{
  "mcpServers": {
    "damonzucconi": {
      "url": "https://damonzucconi-mcp.damonzucconi.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DAMONZUCCONI_MCP_TOKEN}"
      }
    }
  }
}

Setzen Sie DAMONZUCCONI_MCP_TOKEN in der Umgebung, die Cursor erbt, mit demselben Wert wie MCP_AUTH_TOKEN in .dev.vars, und starten Sie dann Cursor neu. Remote-Server unterstützen kein envFile.

Verbindung vom ChatGPT-Desktop

Die ChatGPT-Desktop-App teilt die MCP-Konfiguration mit Codex in ~/.codex/config.toml. Fügen Sie hinzu:

[mcp_servers.damonzucconi]
url = "https://damonzucconi-mcp.damonzucconi.workers.dev/mcp"
bearer_token_env_var = "DAMONZUCCONI_MCP_TOKEN"
default_tools_approval_mode = "writes"

Unter macOS machen Sie das Token für Apps verfügbar, die aus Finder oder Dock gestartet werden:

read -s "DAMONZUCCONI_MCP_TOKEN?MCP token: "
echo
launchctl setenv DAMONZUCCONI_MCP_TOKEN "$DAMONZUCCONI_MCP_TOKEN"
unset DAMONZUCCONI_MCP_TOKEN

Fügen Sie denselben Wert wie MCP_AUTH_TOKEN ein, wenn read dazu auffordert. Das Token wird nicht in config.toml oder im Shell-Verlauf gespeichert.

Beenden Sie ChatGPT vollständig und öffnen Sie es erneut, dann öffnen Sie Einstellungen → MCP-Server und wählen Sie Neu starten. Geben Sie /mcp im Composer ein, um zu bestätigen, dass damonzucconi verbunden ist. Siehe OpenAIs MCP-Dokumentation, falls sich die Desktop-Oberfläche ändert.

Bereitstellung

Die Wrangler-Authentifizierung öffnet einen Browser:

npx wrangler login

Für eine erste Bereitstellung:

npm run deploy
npm run secrets:push

secrets:push lädt die drei Einträge aus .dev.vars hoch. Bei späteren Bereitstellungen führen Sie nur npm run deploy aus, es sei denn, ein Geheimnis hat sich geändert.

Vor der Bereitstellung von Änderungen:

npm run codegen
npm run typecheck
npm run smoke
npm run deploy
MCP_URL=https://damonzucconi-mcp.damonzucconi.workers.dev npm run smoke

GraphQL-Codegenerierung

Queries und Mutationen befinden sich in src/graphql/. npm run codegen führt eine Introspection der Live-API durch und aktualisiert:

• schema.graphql

• src/generated/

Bearbeiten Sie keine generierten Dateien. Wenn Codegen oder Typprüfung nach einer API-Änderung fehlschlägt, aktualisieren Sie die .graphql-Operationen oder ihre Zod-Tool-Schemas, bevor Sie bereitstellen.