Sequential Thinking Tools

mcp-sequentialthinking-tools

Un servidor MCP ligero para registrar pasos de razonamiento secuencial. Es un bloc de notas con historial, ramificaciones, metadatos de revisión y validación opcional para planes de herramientas redactados por el modelo.

No descubre tus otras herramientas MCP y no elige herramientas para el modelo. Si pasas available_tools y recommended_tools, el servidor valida que los nombres recomendados existan y almacena el paso.

¿Por qué usarlo?

Úsalo cuando una tarea se beneficie de un razonamiento explícito e inspeccionable:

• dividir un problema complejo en pasos;
• revisar o ramificar un plan;
• mantener un historial de razonamiento breve por sesión;
• validar nombres de planes de herramientas contra una lista de herramientas proporcionada;
• limpiar o inspeccionar el historial de razonamiento durante una ejecución larga del agente.

No lo uses para solicitudes triviales. Añade sobrecarga.

Herramientas

sequentialthinking_tools

Registra un pensamiento.

Parámetros obligatorios:

• thought — paso de razonamiento actual
• thought_number — número de paso actual
• total_thoughts — estimación actual; se eleva automáticamente si es menor que thought_number
• next_thought_needed — si se necesita otro pensamiento

Parámetros opcionales:

• session_id — contenedor de historial; por defecto default
• is_revision, revises_thought
• branch_from_thought, branch_id
• needs_more_thoughts
• available_tools — matriz de nombres de herramientas u objetos { name, description }
• recommended_tools — recomendaciones redactadas por el modelo para validar/almacenar
• remaining_steps — lista breve de pasos próximos

Ejemplo:

{
	"session_id": "svelte-debug",
	"thought": "First inspect the route files, then run the failing check.",
	"thought_number": 1,
	"total_thoughts": 3,
	"next_thought_needed": true,
	"available_tools": ["read", "bash"],
	"recommended_tools": [
		{
			"tool_name": "read",
			"confidence": 0.9,
			"rationale": "Need to inspect the relevant files before editing.",
			"priority": 1
		}
	]
}

Si recommended_tools contiene un nombre que no está presente en available_tools, la llamada devuelve isError: true y no almacena el pensamiento.

Postura de seguridad

El servidor trata el texto de los pensamientos, las descripciones de herramientas, las justificaciones y el texto de los pasos restantes como entrada no confiable. El texto similar a inyección de prompts se escanea y redacta antes de almacenarse o devolverse en el historial. Las llamadas con redacciones incluyen security_warnings que muestra qué campos coincidieron.

Esto es un filtrado defensivo, no una garantía de que el texto adversarial arbitrario sea seguro. No pongas secretos en pensamientos o descripciones de herramientas.

get_thinking_history

Devuelve los pensamientos almacenados para una sesión.

Parámetros:

• session_id — por defecto default
• branch_id — filtro de rama opcional
• limit — máximo de registros a devolver; por defecto 50, máximo 500

clear_thinking_history

Limpia una sesión o todas las sesiones.

Parámetros:

• session_id — por defecto default
• all_sessions — limpiar todos los contenedores de historial

Prompt

sequential-thinking-guidance

Un prompt breve que le indica al modelo cómo usar este servidor con honestidad: como bloc de notas y validador, no como motor de razonamiento externo.

Configuración

Claude Desktop / clientes MCP compatibles

{
	"mcpServers": {
		"mcp-sequentialthinking-tools": {
			"command": "npx",
			"args": ["-y", "mcp-sequentialthinking-tools"],
			"env": {
				"MAX_HISTORY_SIZE": "1000"
			}
		}
	}
}

MAX_HISTORY_SIZE es por sesión y por defecto 1000.

El servidor usa tmcp e incluye un transporte stdio pequeño que acepta tanto mensajes MCP estándar con marco Content-Length como JSON delimitado por líneas usado por herramientas tmcp más antiguas.

Desarrollo

pnpm install
pnpm test
pnpm build
pnpm check

Este proyecto usa vite-plus para la orquestación de compilación, pruebas, formato y lint.

Publicación

pnpm changeset
pnpm changeset version
pnpm release

Licencia

Licencia MIT — ver LICENSE.

Agradecimientos

• Construido sobre el Model Context Protocol
• Adaptado del MCP Sequential Thinking Server