mcp-sequentialthinking-tools
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 actualthought_number— número de paso actualtotal_thoughts— estimación actual; se aumenta automáticamente si es menor quethought_numbernext_thought_needed— si se necesita otro pensamiento
Parámetros opcionales:
session_id— depósito de historial; el valor predeterminado esdefaultis_revision,revises_thoughtbranch_from_thought,branch_idneeds_more_thoughtsavailable_tools— matriz de nombres de herramientas u objetos{ name, description }recommended_tools— recomendaciones creadas por el modelo para validar/almacenarremaining_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 esdefaultbranch_id— filtro de rama opcionallimit— registros máximos a devolver; el valor predeterminado es50, el máximo500
clear_thinking_history
Limpia una sesión o todas las sesiones.
Parámetros:
session_id— el valor predeterminado esdefaultall_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 checkEste proyecto utiliza vite-plus para la orquestación de compilación, prueba, formato y linting.
Publicación
pnpm changeset
pnpm changeset version
pnpm releaseLicencia
Licencia MIT — ver LICENSE.
Agradecimientos
Construido sobre el Protocolo de Contexto de Modelo (MCP)
Adaptado del Servidor MCP Sequential Thinking
Available Tools
3 toolsclear_thinking_historyClear recorded sequential-thinking history for one session or all sessions.C
Clear recorded sequential-thinking history for one session or all sessions.
Inputs: session_id, all_sessions.
get_thinking_historyReturn recorded thoughts for a session. Use this to inspect or resume prior reasoning.C
Return recorded thoughts for a session. Use this to inspect or resume prior reasoning.
Inputs: limit, branch_id, session_id.
sequentialthinking_toolsRecord one step of sequential reasoning. Optionally include available_tools and recommended_tools; recommendations are validated, not generated, by this server.C
Record one step of sequential reasoning. Optionally include available_tools and recommended_tools; recommendations are validated, not generated, by this server.
Inputs: thought (required), thought_number (required), total_thoughts (required), next_thought_needed (required), +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools map cleanly to distinct actions on the same resource: write a thought, read the history, and clear it. There is no overlap or risk of misselection between recording, retrieving, and clearing.
get_thinking_history and clear_thinking_history follow a consistent verb_noun pattern, but sequentialthinking_tools breaks it entirely, using a compound noun with no verb and no clear action cue. The mix is readable but not uniform.
Three tools is lean but adequate for a reasoning-history server covering write, read, and clear. It is on the thin side, with no session-listing or search capability to round it out.
The record/get/clear trio covers the basic lifecycle of a thinking log with no dead ends. Minor gaps exist, such as listing sessions or fetching a single thought by id, which agents could work around.
Maintenance
Related MCP Connectors
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for generating rough-draft project plans from natural-language prompts.
Hybrid human + AI expertise for faster, trusted answers and decisions via MCP Server.
Related MCP Servers
- AlicenseAqualityBmaintenanceThis server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.590 PyPI963MIT
- AlicenseAqualityDmaintenanceA MCP server that implements sequential thinking protocols, provides structured problem-solving methods, decomposes complex problems into manageable steps, and supports iterative optimization and alternative reasoning paths.12Apache 2.0
- AlicenseNot gradedqualityDmaintenanceA sequential thinking tool based on the MCP protocol, used to break down complex problems into manageable steps and provide intelligent tool recommendations for each step.2Apache 2.0
- AlicenseAqualityDmaintenanceA structured problem-solving MCP server that breaks down complex tasks into sequential steps, supports iterative refinement and branching, and helps maintain context and explore alternative reasoning paths.141MIT