Sequential Thinking Tools

mcp-sequentialthinking-tools

Um servidor MCP leve para registrar etapas de raciocínio sequencial. É um rascunho com histórico, ramificações, metadados de revisão e validação opcional para planos de ferramentas criados por modelos.

Ele não descobre suas outras ferramentas MCP e não escolhe ferramentas para o modelo. Se você passar available_tools e recommended_tools, o servidor valida se os nomes recomendados existem e armazena a etapa.

Por que usar?

Use isto quando uma tarefa se beneficia de raciocínio explícito e inspecionável:

• dividir um problema complexo em etapas;
• revisar ou ramificar um plano;
• manter um pequeno histórico de raciocínio por sessão;
• validar nomes de planos de ferramentas contra uma lista de ferramentas fornecida;
• limpar ou inspecionar o histórico de raciocínio durante uma execução longa de agente.

Não use para solicitações triviais. Isso adiciona sobrecarga.

Ferramentas

sequentialthinking_tools

Registra um pensamento.

Parâmetros obrigatórios:

• thought — etapa de raciocínio atual
• thought_number — número da etapa atual
• total_thoughts — estimativa atual; aumentada automaticamente se for menor que thought_number
• next_thought_needed — se outro pensamento é necessário

Parâmetros opcionais:

• session_id — bucket de histórico; padrão é default
• is_revision, revises_thought
• branch_from_thought, branch_id
• needs_more_thoughts
• available_tools — array de nomes de ferramentas ou objetos { name, description }
• recommended_tools — recomendações criadas pelo modelo para validar/armazenar
• remaining_steps — lista curta de próximas etapas

Exemplo:

{
	"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
		}
	]
}

Se recommended_tools contiver um nome que não está presente em available_tools, a chamada retorna isError: true e não armazena o pensamento.

Postura de segurança

O servidor trata texto de pensamentos, descrições de ferramentas, justificativas e texto de próximas etapas como entrada não confiável. Texto semelhante a injeção de prompt é verificado e redigido antes de ser armazenado ou retornado no histórico. Chamadas com redações incluem security_warnings mostrando quais campos corresponderam.

Isso é filtragem defensiva, não uma garantia de que texto adversário arbitrário seja seguro. Não coloque segredos em pensamentos ou descrições de ferramentas.

get_thinking_history

Retorna pensamentos armazenados para uma sessão.

Parâmetros:

• session_id — padrão é default
• branch_id — filtro de ramificação opcional
• limit — máximo de registros a retornar; padrão 50, máximo 500

clear_thinking_history

Limpa uma sessão ou todas as sessões.

Parâmetros:

• session_id — padrão é default
• all_sessions — limpa todos os buckets de histórico

Prompt

sequential-thinking-guidance

Um prompt curto que diz ao modelo como usar este servidor honestamente: como um rascunho e validador, não como um motor de raciocínio externo.

Configuração

Claude Desktop / clientes MCP compatíveis

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

MAX_HISTORY_SIZE é por sessão e o padrão é 1000.

O servidor usa tmcp e inclui um pequeno transporte stdio que aceita tanto mensagens MCP padrão com frame Content-Length quanto JSON delimitado por nova linha usado por ferramentas mais antigas tmcp.

Desenvolvimento

pnpm install
pnpm test
pnpm build
pnpm check

Este projeto usa vite-plus para orquestração de build, teste, formatação e lint.

Publicação

pnpm changeset
pnpm changeset version
pnpm release

Licença

Licença MIT — veja LICENSE.

Agradecimentos

• Construído sobre o Model Context Protocol
• Adaptado do MCP Sequential Thinking Server