mcp-sequentialthinking-tools

mcp-sequentialthinking-tools

逐次的な推論ステップを記録する軽量な MCP サーバーです。 履歴、分岐、改訂メタデータ、モデルが作成したツール計画の 任意の検証機能を備えたスクラッチパッドです。

ほかの MCP ツールを検出することはなく、モデルに代わって ツールを選択することもありません。available_tools と recommended_tools を渡すと、サーバーは推奨された名前が 存在することを検証し、ステップを保存します。

なぜ使うのですか？

明示的で確認可能な推論が役立つタスクで使用してください。

• 複雑な問題をステップに分解する。
• 計画を修正または分岐する。
• セッションごとに小規模な推論履歴を保持する。
• 提供されたツール一覧とツール計画の名前を照合して検証する。
• エージェントの長時間実行中に推論履歴を消去または確認する。

簡単なリクエストには使用しないでください。オーバーヘッドが発生します。

ツール

sequentialthinking_tools

1つの思考を記録します。

必須パラメーター：

• 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

1つのセッション、またはすべてのセッションを消去します。

パラメーター：

• 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 を使用し、標準の Content-Length フレーム形式の MCP メッセージと、 旧バージョンの tmcp ツールで使われる改行区切り JSON の両方を受け付ける 小規模な stdio トランスポートを備えています。

開発

pnpm install
pnpm test
pnpm build
pnpm check

このプロジェクトでは、ビルド、テスト、フォーマット、lint の オーケストレーションに vite-plus を使用しています。

公開

pnpm changeset
pnpm changeset version
pnpm release

ライセンス

MIT License — LICENSE を参照してください。

謝辞

• Model Context Protocol を基盤に構築されています
• MCP Sequential Thinking Server をもとに改変されています