Skip to main content
Glama
mcp-sequentialthinking-tools

mcp-sequentialthinking-tools

by spences10

mcp-sequentialthinking-tools

built with vite+ tested with vitest

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

Available Tools

3 tools
clear_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

    B3/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency3/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      1
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      2
      Apache 2.0