Timers Studio — MCP-Server

Öffentlicher Model Context Protocol-Server für Timers Studio, die professionelle Broadcast-Timer-Plattform. Gehostet unter https://mcp.timers.studio/mcp. Ermöglicht Claude Desktop, ChatGPT, Gemini, Perplexity und jedem MCP-fähigen Client die Beantwortung von Fragen potenzieller Kunden zu Timers Studio mit First-Party-Daten: Wettbewerbspositionierung, Anwendungsfälle, Personas und empfohlene Pläne.

Umfang

Schreibgeschützte Marketing-Oberfläche. Der Server dient dazu, potenzielle Kunden zu konvertieren, die in einem LLM-Client nach Timers Studio recherchieren. Er liefert Positionierung, Wettbewerbsvergleiche, Anwendungsfälle und Personas.

Er steuert keine Studios. Studio-Operationen (Start, Pause, Zurücksetzen, Agenda-Transport, Nachrichtenübertragung) befinden sich ausschließlich in der authentifizierten REST-API unter api.timers.studio und erfordern ein Benutzerkonto. Diese Oberfläche wird bewusst nicht über MCP bereitgestellt.

Tools

Alle vier Tools sind schreibgeschützt und erfordern keine Authentifizierung.

Alle Tools rufen https://timers.studio/api/ai/context ab (im Arbeitsspeicher für 5 Minuten zwischengespeichert).

Wire-Protokoll

JSON-RPC 2.0 über HTTP, Streamable HTTP-Transport, zustandsloser Modus. Endpunkt: https://mcp.timers.studio/mcp. Protokollversion: 2025-03-26.

Unterstützte Methoden: initialize, tools/list, tools/call, resources/list, resources/templates/list, prompts/list, ping, notifications/*.

Verbindung von einem Client

Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "timers-studio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.timers.studio/mcp"]
    }
  }
}

Starten Sie Claude Desktop neu. Fragen Sie: "Vergleiche Timers Studio mit Stagetimer."

Smithery

Bereits veröffentlicht. Mit einem Klick aus dem Smithery-Marktplatz installieren.

Generischer HTTP MCP-Client

Verweisen Sie auf https://mcp.timers.studio/mcp mit Content-Type: application/json und JSON-RPC 2.0-Payloads.

curl -X POST https://mcp.timers.studio/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Lokale Entwicklung

npm install
npm run dev      # wrangler dev on http://localhost:8787

Smoke-Tests:

# tools/list
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

# call a read tool
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"find_competitor","arguments":{"slug":"stagetimer"}}}' | jq

Bereitstellung

Gehostet auf Cloudflare Workers. Um Ihren eigenen Fork bereitzustellen:

npx wrangler login
npm run deploy

Konfigurieren Sie dann Ihre Cloudflare-Zone:

1. Fügen Sie einen DNS CNAME-Eintrag hinzu (z. B. mcp → 100% Proxy).

2. Workers Routes → binden Sie mcp.<ihre-domain>/* an den Worker.

Sicherheitsmodell

• Schreibgeschützte Oberfläche. Dieselben Daten wie https://timers.studio/api/ai/context, bereitgestellt über JSON-RPC statt REST.

• Kein Bearer-Token, keine Authentifizierung, keine Weiterleitung an Upstream-APIs. Der Worker hat keine Anmeldeinformationen, keine Geheimnisse, keinen Pfad zum Timers Studio-Backend.

• Zustandslos. Nichts wird pro Benutzer zwischengespeichert.

• CORS erlaubt jeden Ursprung auf /mcp (MCP-Clients haben keinen konsistenten Ursprung), was für einen öffentlichen Lese-Endpunkt angemessen ist.

Architektur

LLM client (Claude / ChatGPT / Gemini / Perplexity / IDE)
      │
      │  JSON-RPC 2.0 over HTTPS
      ▼
mcp.timers.studio/mcp  (Cloudflare Worker, stateless)
      │
      │  GET (cached 5 min)
      ▼
timers.studio/api/ai/context  (read-only marketing JSON)

Der Worker ist ein schlanker JSON-RPC-Adapter über dem öffentlichen /api/ai/context-Endpunkt. Das Wettbewerbsarsenal befindet sich unter timers.studio und ist die einzige Quelle der Wahrheit.

Verwandte Projekte

• Timers Studio Plattform: timers.studio

• Dokumentation: docs.timers.studio

• AI-Manifest: timers.studio/api/ai/manifest

• Companion-Modul: github.com/bitfocus/companion-module-timers-studio

Lizenz

MIT. Siehe LICENSE.