mcp-sequentialthinking-tools

Un servidor MCP ligero para registrar pasos de razonamiento secuencial. Es un bloc de notas con historial, ramificación, metadatos de revisión y validación opcional para planes de herramientas creados 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 y auditable:

• desglosar un problema complejo en pasos;

• revisar o ramificar un plan;

• mantener un pequeño historial de razonamiento 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.

Related MCP server: Sequential-Thinking

Herramientas

sequentialthinking_tools

Registra un pensamiento.

Parámetros requeridos:

• thought — paso de razonamiento actual

• thought_number — número de paso actual

• total_thoughts — estimación actual; se aumenta automáticamente si es menor que thought_number

• next_thought_needed — si se necesita otro pensamiento

Parámetros opcionales:

• session_id — depósito de historial; el valor predeterminado es 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 creadas por el modelo para validar/almacenar

• remaining_steps — lista corta de los próximos pasos

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 del pensamiento, las descripciones de las herramientas, las justificaciones y el texto de los pasos restantes como entrada no confiable. El texto similar a una inyección de prompt se escanea y se redacta antes de ser almacenado o devuelto en el historial. Las llamadas con redacciones incluyen security_warnings que muestran qué campos coincidieron.

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

get_thinking_history

Devuelve los pensamientos almacenados para una sesión.

Parámetros:

• session_id — el valor predeterminado es default

• branch_id — filtro de rama opcional

• limit — registros máximos a devolver; el valor predeterminado es 50, el máximo 500

clear_thinking_history

Limpia una sesión o todas las sesiones.

Parámetros:

• session_id — el valor predeterminado es default

• all_sessions — limpiar todos los depósitos de historial

Prompt

sequential-thinking-guidance

Un prompt corto que le dice al modelo cómo usar este servidor honestamente: como un bloc de notas y validador, no como un 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 el valor predeterminado es 1000.

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

Desarrollo

pnpm install
pnpm test
pnpm build
pnpm check

Este proyecto utiliza vite-plus para la orquestación de compilación, prueba, formato y linting.

Publicación

pnpm changeset
pnpm changeset version
pnpm release

Licencia

Licencia MIT — ver LICENSE.

Agradecimientos

• Construido sobre el Protocolo de Contexto de Modelo (MCP)

• Adaptado del Servidor MCP Sequential Thinking