mcp-think

Un servidor MCP remoto para pensamiento secuencial estructurado, creado para Cloudflare Workers.

Arquitectura

• Cloudflare Worker expone /mcp a través de Streamable HTTP.

• MCP SDK v2 define las herramientas.

• Durable Objects + SQLite persisten cada secuencia.

• Una secuencia se identifica mediante un sequenceId explícito; las sesiones del protocolo MCP no transportan estado de aplicación.

Este diseño sigue las directrices actuales de Cloudflare: los nuevos servidores MCP usan el controlador v2/sin estado, mientras que el estado de aplicación para flujos de trabajo de varios pasos reside detrás de un límite explícito de Durable Object. McpAgent está obsoleto y no se usa aquí intencionadamente.

Related MCP server: handoff-mcp

Herramientas

start_sequence

Crea una secuencia y devuelve un sequenceId.

add_step

Añade un paso estructurado. Úsalo para resúmenes, suposiciones, evidencia, hipótesis o decisiones. El servidor no está pensado para exponer ni almacenar cadenas de pensamiento ocultas.

revise_step

Crea una nueva revisión de un paso anterior a la vez que conserva el registro original.

get_sequence

Devuelve los metadatos de la secuencia y todos los pasos almacenados.

finish_sequence

Almacena la conclusión final y marca la secuencia como completada.

reset_sequence

Elimina los datos de la secuencia almacenados.

Desarrollo local

npm install
npm run typecheck
npm run dev

El endpoint MCP local es:

http://localhost:8787/mcp

Comprobación de estado:

http://localhost:8787/health

Despliegue

Autentica Wrangler con tu cuenta de Cloudflare y ejecuta:

npm run deploy

Cloudflare aprovisionará el Durable Object respaldado por SQLite a partir de la migración en wrangler.jsonc.

Flujo de ejemplo

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

Hoja de ruta de seguridad

El MVP no tiene autenticación a propósito. Antes de exponer el endpoint públicamente, añade OAuth u otra capa de autenticación y vincula la propiedad de la secuencia al principal autenticado. La guía de MCP de Cloudflare también recomienda una validación explícita de Host/Origin y autenticación en lugar de tratar CORS como un mecanismo de autenticación.