MCPサーバ - Sequential Thinkingのソースを表示

== 概要 ==
Sequential Thinking MCP Server は、Model Context Protocol (MCP) を通じてAIアシスタントに構造化された段階的思考プロセスを提供するサーバである。<br>
Anthropicが開発したMCP公式リファレンス実装の一つであり、MITライセンスで公開されている。<br>
<br>
複雑な問題を管理可能なステップに分解し、動的かつ反省的な問題解決を実現する。<br>
理解が深まるにつれて思考を修正・精緻化したり、推論の代替経路へ分岐させたりすることが可能である。<br>
<br>
主な特徴は以下の通りである。<br>
* 複雑な問題を段階的なステップに分解
* 理解が深まるにつれて思考を修正・精緻化
* 推論の代替経路への分岐
* 必要な思考ステップ数の動的調整
* ソリューション仮説の生成と検証
<br>
提供するツールは <u>sequential_thinking</u> の1つのみであるが、思考番号・修正・分岐等のパラメータにより柔軟な推論プロセスを制御できる。<br>
<br>
Claude Desktop、Claude Code、VS Code、Cursor、ChatGPT等の主要なMCPクライアントに対応している。<br>
<br><br>

== 動作要件 ==
==== 前提条件 ====
Sequential Thinking MCP Serverを使用するために必要な前提条件を以下に示す。<br>
<br>
* Node.js v18以上
*: <code>npx</code> コマンドを使用してMCPサーバを実行するために必要
* <code>npx</code> コマンド
*: Node.jsに同梱されている。
*: MCPサーバを直接実行するために使用する。
<br><br>

== インストール ==
==== npxを使用したインストール (推奨) ====
<code>npx</code> コマンドを使用する場合、インストール不要でSequential Thinking MCP Serverを直接実行できる。<br>
以下のコマンドを実行して、MCPサーバを起動する。<br>
<br>
 npx -y @modelcontextprotocol/server-sequential-thinking
<br>
MCPクライアントの設定ファイルで指定する場合は、後述の各クライアント設定を参照すること。<br>
<br>
==== Dockerを使用したインストール ====
Node.jsをインストールせずにDockerでMCPサーバを実行できる。<br>
<br>
 docker run --rm -i mcp/sequentialthinking
<br>
==== npmを使用したグローバルインストール ====
グローバルにインストールする場合は、以下のコマンドを実行する。<br>
<br>
 npm install -g @modelcontextprotocol/server-sequential-thinking
<br><br>

== MCPクライアントの設定 ==
==== 設定ファイルの場所 ====
各MCPクライアントの設定ファイルの場所は以下の通りである。<br>
<br>
Claude Desktopの設定ファイルを以下に示す。<br>
* Linux
*: <u>~/.config/Claude/claude_desktop_config.json</u>
* MacOS
*: <u>~/Library/Application Support/Claude/claude_desktop_config.json</u>
* Windows
*: <u>%APPDATA%\Claude\claude_desktop_config.json</u>
<br>
Claude Codeの設定ファイルを以下に示す。<br>
* ローカルスコープ
*: <u>.mcp.json</u> (プロジェクトルート) : <code>claude mcp add</code> コマンドで生成される。
* ユーザスコープ
*: <u>~/.claude.json</u> (ホームディレクトリ)
<br>
VS Codeの設定ファイルを以下に示す。<br>
* <u>.vscode/mcp.json</u> (プロジェクトルート)
<br>
Cursorの設定ファイルを以下に示す。<br>
* グローバル設定
*: <u>~/.cursor/mcp.json</u>
* プロジェクト設定
*: <u>.cursor/mcp.json</u>
<br>
==== Claude Desktopの設定 ====
<u>claude_desktop_config.json</u> ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
     }
   }
 }
 </syntaxhighlight>
<br>
設定ファイルを保存した後、Claude Desktopを再起動して設定を反映する。<br>
<br>
==== Claude Codeの設定 ====
Claude Codeでは、<code>claude mcp add</code> コマンドを実行してMCPサーバを追加できる。<br>
<br>
 claude mcp add sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking
<br>
プロジェクトの <u>.mcp.json</u> ファイルに設定を記述する場合は、以下に示す内容を記述する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== VS Code / Cursorの設定 ====
<u>.vscode/mcp.json</u> または <u>.cursor/mcp.json</u> ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== Dockerを使用した設定 ====
Dockerを使用する場合は、設定ファイルに以下に示す内容を設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "docker",
       "args": ["run", "--rm", "-i", "mcp/sequentialthinking"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== Windowsでの設定の注意点 ====
Windowsでは、<code>npx</code> を使用するMCPサーバの場合、<code>cmd /c</code> ラッパーが必須である。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "cmd",
       "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-sequential-thinking"]
     }
   }
 }
 </syntaxhighlight>
<br><br>

== 環境変数 ==
==== 環境変数一覧 ====
下表に、Sequential Thinking MCP Serverの動作をカスタマイズするための環境変数を示す。<br>
<br>
<center>
{| class="wikitable"
|+ 環境変数の一覧
! 環境変数 !! 説明
|-
| <code>DISABLE_THOUGHT_LOGGING</code> || 思考プロセスのコンソールログ出力を制御する。<br><br><code>true</code>: ログ出力を無効化する<br><code>false</code>: ログ出力を有効化する (デフォルト)
|}
</center>
<br>
Claude Desktopの設定ファイルで環境変数を指定する場合は、以下に示すように設定する。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"],
       "env": {
         "DISABLE_THOUGHT_LOGGING": "true"
       }
     }
   }
 }
 </syntaxhighlight>
<br><br>

== 提供ツール ==
Sequential Thinking MCP Serverが提供するツールは <code>sequential_thinking</code> の1つのみである。<br>
このツールは、必須パラメータとオプションパラメータを組み合わせて、柔軟な段階的思考プロセスを実現する。<br>
<br>
==== 必須パラメータ ====
下表に、<code>sequential_thinking</code> ツールの必須パラメータを示す。<br>
<br>
<center>
{| class="wikitable"
|+ 必須パラメータの一覧
! パラメータ !! 型 !! 説明
|-
| <code>thought</code> || 文字列 || 現在のステップにおける思考内容
|-
| <code>nextThoughtNeeded</code> || 真偽値 || さらなる思考ステップが必要かどうかを示す。<br><code>true</code>: 継続が必要<br><code>false</code>: 結論に到達
|-
| <code>thoughtNumber</code> || 整数 || 現在の思考番号 (1から開始)
|-
| <code>totalThoughts</code> || 整数 || 問題解決に必要と推定される総思考数<br>後から修正することも可能
|}
</center>
<br>
==== オプションパラメータ ====
下表に、<code>sequential_thinking</code> ツールのオプションパラメータを示す。<br>
<br>
これらのパラメータにより、修正・分岐・延長といった高度な推論制御が可能になる。<br>
<br>
<center>
{| class="wikitable"
|+ オプションパラメータの一覧
! パラメータ !! 型 !! 説明
|-
| <code>isRevision</code> || 真偽値 || 前の思考ステップの修正かどうかを示す。<br>デフォルト値は <code>false</code>
|-
| <code>revisesThought</code> || 整数 || 修正対象の思考番号。<br><code>isRevision</code> が <u>true</u> の場合に使用する。
|-
| <code>branchFromThought</code> || 整数 || 分岐開始点の思考番号<br>代替経路を探索する場合に使用する。
|-
| <code>branchId</code> || 文字列 || 分岐を識別するための一意な識別子
|-
| <code>needsMoreThoughts</code> || 真偽値 || 推定思考数を超えて追加の思考が必要かどうかを示す。
|}
</center>
<br><br>

== 使用例 ==
Sequential Thinking MCP Serverのツールは、AIアシスタントが自然言語の指示を受けて自動的に呼び出す。<br>
<br>
==== 設計課題への適用 ====
複雑な設計課題に段階的思考を適用する場合の操作例を以下に示す。<br>
<br>
* マイクロサービスアーキテクチャを計画する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 マイクロサービスアーキテクチャを構築するための包括的な計画を、段階的に考えてください。
 </syntaxhighlight>
*: <br>
* システム設計のレビューを行う場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 このシステム設計のセキュリティ、スケーラビリティ、保守性を段階的に評価してください。
 </syntaxhighlight>
*: <br>
<br>
==== 技術選定・比較分析 ====
技術の選定や比較分析を段階的に行う場合の操作例を以下に示す。<br>
<br>
* クラウドプロバイダを比較する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 AWSとGCPのメリット・デメリットを段階的に比較分析してください。
 </syntaxhighlight>
*: <br>
<br>
==== デバッグ・問題解析 ====
エラーや問題の原因を段階的に分析する場合の操作例を以下に示す。<br>
<br>
* エラーの原因を特定して解決策を提案する場合
*: <syntaxhighlight lang="text">
 # プロンプト例 :
 
 このエラーの原因を段階的に分析して、解決策を提案してください。
 </syntaxhighlight>
*: <br>
<br><br>

== トラブルシューティング ==
==== 共通の問題 ====
下表に、OS問わず発生する可能性がある問題と対処法を示す。<br>
<br>
<center>
{| class="wikitable"
|+ 共通トラブルシューティング
! 問題 !! 対処法
|-
| Node.jsがインストールされていない || Node.js v18以上をインストールする。<br>[https://nodejs.org/ Node.js公式サイト]からインストーラをダウンロードする。
|-
| ツールが応答しない || メモリ不足でないか確認する。<br>初回実行時はパッケージのダウンロードが発生するため、ネットワーク接続を確認する。
|-
| JSON設定の構文エラーが発生する || JSONバリデータで設定ファイルの構文を確認する。<br>全角括弧（）が含まれていないかを確認する。
|-
| ツールがクライアントに表示されない || MCPクライアントを完全に再起動する。
|}
</center>
<br>
==== Windowsでの問題 ====
下表に、Windows環境で発生する可能性がある問題と対処法を示す。<br>
<br>
<center>
{| class="wikitable"
|+ Windowsのトラブルシューティング
! 問題 !! 対処法
|-
| npxコマンドが見つからない || <code>cmd /c</code> ラッパーを設定ファイルに追加する。<br>または、以下に示すコマンドを実行してグローバルインストールする。<br><code>npm install -g @modelcontextprotocol/server-sequential-thinking</code>
|-
| ENOENTエラーが発生する || 設定ファイルに環境変数 (<code>PATH</code> 等) を明示的に指定する。
|}
</center>
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,Sequential Thinking,MCP,Model Context Protocol,段階的思考,Claude,AI,問題解決,推論,sequential_thinking,Anthropic,Claude Desktop,Claude Code,VS Code,Cursor
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]