mcp-sequentialthinking-tools

Легковесный MCP-сервер для записи последовательных этапов рассуждения. Это черновик с поддержкой истории, ветвления, метаданных пересмотра и опциональной проверки планов использования инструментов, созданных моделью.

Он не обнаруживает другие ваши MCP-инструменты и не выбирает инструменты за модель. Если вы передадите available_tools и recommended_tools, сервер проверит, существуют ли рекомендованные имена, и сохранит этап.

Зачем это использовать?

Используйте это, когда задача выигрывает от явных, проверяемых рассуждений:

• разбиение запутанной проблемы на этапы;

• пересмотр или ветвление плана;

• ведение небольшой истории рассуждений по сессиям;

• проверка имен инструментов в плане на соответствие предоставленному списку инструментов;

• очистка или проверка истории рассуждений во время длительного выполнения агента.

Не используйте это для тривиальных запросов. Это создает дополнительные накладные расходы.

Related MCP server: Sequential-Thinking

Инструменты

sequentialthinking_tools

Записывает одну мысль.

Обязательные параметры:

• thought — текущий этап рассуждения

• thought_number — номер текущего этапа

• total_thoughts — текущая оценка; автоматически увеличивается, если меньше thought_number

• next_thought_needed — требуется ли еще одна мысль

Опциональные параметры:

• session_id — корзина истории; по умолчанию default

• is_revision, revises_thought

• branch_from_thought, branch_id

• needs_more_thoughts

• available_tools — массив имен инструментов или объектов { name, description }

• recommended_tools — рекомендации, созданные моделью для проверки/сохранения

• remaining_steps — краткий список предстоящих этапов

Пример:

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

Если recommended_tools содержит имя, отсутствующее в available_tools, вызов возвращает isError: true и не сохраняет мысль.

Безопасность

Сервер обрабатывает текст мыслей, описания инструментов, обоснования и текст оставшихся этапов как ненадежные входные данные. Текст, похожий на инъекцию промпта, сканируется и редактируется перед сохранением или возвратом в историю. Вызовы с редактированием включают security_warnings, показывающие, какие поля совпали.

Это защитная фильтрация, а не гарантия того, что произвольный состязательный текст безопасен. Не помещайте секреты в мысли или описания инструментов.

get_thinking_history

Возвращает сохраненные мысли для сессии.

Параметры:

• session_id — по умолчанию default

• branch_id — опциональный фильтр ветки

• limit — максимальное количество записей для возврата; по умолчанию 50, максимум 500

clear_thinking_history

Очищает одну сессию или все сессии.

Параметры:

• session_id — по умолчанию default

• all_sessions — очистить все корзины истории

Промпт

sequential-thinking-guidance

Короткий промпт, который говорит модели, как честно использовать этот сервер: как черновик и валидатор, а не как внешний механизм рассуждений.

Конфигурация

Claude Desktop / совместимые MCP-клиенты

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

MAX_HISTORY_SIZE устанавливается для каждой сессии и по умолчанию равен 1000.

Сервер использует tmcp и включает небольшой транспорт stdio, который принимает как стандартные MCP-сообщения, обрамленные Content-Length, так и JSON с разделителями-переносами строк, используемый старыми инструментами tmcp.

Разработка

pnpm install
pnpm test
pnpm build
pnpm check

Этот проект использует vite-plus для сборки, тестирования, форматирования и оркестрации линтинга.

Публикация

pnpm changeset
pnpm changeset version
pnpm release

Лицензия

Лицензия MIT — см. LICENSE.

Благодарности

• Построено на базе Model Context Protocol

• Адаптировано из MCP Sequential Thinking Server