mcp-think

Ein Remote-MCP-Server für strukturiertes sequenzielles Denken, gebaut für Cloudflare Workers.

Architektur

• Cloudflare Worker stellt /mcp über Streamable HTTP bereit.

• MCP SDK v2 definiert die Tools.

• Durable Objects + SQLite persistieren jede Sequenz.

• Eine Sequenz wird über eine explizite sequenceId adressiert; MCP-Protokollsitzungen tragen keinen Anwendungszustand.

Dieses Design folgt der aktuellen Cloudflare-Empfehlung: Neue MCP-Server verwenden den v2/stateless-Handler, während Anwendungszustand für mehrstufige Workflows hinter einer expliziten Durable-Object-Grenze liegt. McpAgent ist veraltet und wird hier bewusst nicht verwendet.

Related MCP server: handoff-mcp

Tools

start_sequence

Erstellt eine Sequenz und gibt eine sequenceId zurück.

add_step

Fügt einen strukturierten Schritt hinzu. Verwenden Sie dies für Zusammenfassungen, Annahmen, Belege, Hypothesen oder Entscheidungen. Der Server ist nicht dafür gedacht, versteckte Gedankenketten (chain-of-thought) offenzulegen oder zu speichern.

revise_step

Erstellt eine neue Revision eines vorherigen Schritts, während der ursprüngliche Datensatz erhalten bleibt.

get_sequence

Gibt die Sequenzmetadaten und alle gespeicherten Schritte zurück.

finish_sequence

Speichert die endgültige Schlussfolgerung und markiert die Sequenz als abgeschlossen.

reset_sequence

Löscht die gespeicherten Sequenzdaten.

Lokale Entwicklung

npm install
npm run typecheck
npm run dev

Der lokale MCP-Endpunkt ist:

http://localhost:8787/mcp

Health-Check:

http://localhost:8787/health

Bereitstellung

Authentifizieren Sie Wrangler mit Ihrem Cloudflare-Konto und führen Sie aus:

npm run deploy

Cloudflare stellt das SQLite-gestützte Durable Object aus der Migration in wrangler.jsonc bereit.

Beispielablauf

start_sequence(goal)
      ↓
sequenceId
      ↓
add_step(sequenceId, ...)
      ↓
add_step(sequenceId, ...)
      ↓
revise_step(sequenceId, stepId, ...)
      ↓
get_sequence(sequenceId)
      ↓
finish_sequence(sequenceId, conclusion)

Sicherheits-Roadmap

Das MVP hat bewusst keine Authentifizierung. Bevor Sie den Endpunkt öffentlich zugänglich machen, fügen Sie OAuth oder eine andere Authentifizierungsebene hinzu und binden Sie die Sequenzinhaberschaft an den authentifizierten Prinzipal. Die MCP-Anleitung von Cloudflare empfiehlt außerdem eine explizite Host-/Origin-Validierung und Authentifizierung, anstatt CORS als Authentifizierungsmechanismus zu behandeln.