Sequential Thinking MCP Server

Sequential Thinking MCP サーバー

各思考セッションに関連付けられた連続思考ログを Recall に自動的に書き込み、構造化された思考プロセスを通じて動的かつ内省的な問題解決を実現するツールを提供する MCP サーバーの実装です。

機能

Sequential Thinking MCP では、次の機能を利用できます。

• 段階的な問題解決

  • 複雑な問題を、取り組みやすい段階に分解します
  • 理解が深まるにつれて、思考を見直して洗練させます
  • 推論の別の経路へ分岐します
  • 思考の総数を動的に調整します

• 仮説の管理

  • 解決策の仮説を生成します
  • 思考の連鎖に基づいて仮説を検証します
  • 必要に応じて修正分析を行います

• Recall との連携

  • すべての連続思考セッションをオンチェーンに安全に保存します
  • 思考履歴全体にアクセスできます
  • 特定の思考セッションを取得できます
  • 保存されたすべてのセッションを一覧表示できます

セキュリティ ⚠️

重要：秘密鍵の保護

この MCP サーバーでは、Recall の操作に秘密鍵が必要です。この機密情報を保護するために、次の点にご注意ください。

1. 秘密鍵や .env ファイルの内容を絶対に共有しないでください
2. 秘密鍵を表示するコマンド（cat .env など）は絶対に実行しないでください
3. 承認せずに LLM がシェルコマンドを直接実行することを絶対に許可しないでください
4. .env ファイルを使用する場合は、アクセス権を制限して保存してください：chmod 600 .env

複数層の保護

このサーバーでは、秘密鍵を安全に保つために複数層のセキュリティを実装しています。

1. 秘密鍵の隔離

• 秘密鍵は初期化時にのみ読み込まれます
• 読み込み後、鍵は環境変数から直ちに削除されます
• 実際の鍵がログに記録されたり、LLM に送信されたりすることはありません

2. ログの保護

• ログ内の秘密鍵に該当するパターンを自動的に編集します
• コンソール出力をフィルタリングし、秘密鍵を [REDACTED] に置き換えます
• 表示前に機密フィールドをマスクするオブジェクトのサニタイズ

3. アクセスの防止

• 環境変数を安全に処理します
• 必須の環境変数を厳密に検証します
• シークレットの漏えいを防ぐため、コンソール出力をサニタイズします

Recall との連携

この MCP サーバーには Recall との連携機能が含まれており、連続思考ログをオンチェーンに安全に保存できます。各クエリのすべての思考ステップは、Recall のバケットに自動的に保存されます。

設定

Recall との連携を使用するには、次の環境変数を設定する必要があります。

• RECALL_PRIVATE_KEY（必須）：Recall の秘密鍵
• RECALL_NETWORK（任意）：接続先のネットワーク（testnet または mainnet。デフォルトは testnet）
• RECALL_BUCKET_ALIAS（任意）：ログを保存するバケットのエイリアス（デフォルトは 'sequential-thinking-logs'）
• RECALL_LOG_PREFIX（任意）：バケットに保存するログファイルのプレフィックス（デフォルトは 'sequential-'）

各思考はメタデータとともに個別に保存され、思考セッションの完了時にはセッション全体が保存されます。これにより、次のことが可能になります。

• 推論の連鎖全体を確認する
• 思考プロセスを分析する
• 価値のある問題解決の手法を将来参照できるように保存する
• 推論パターンのナレッジベースを構築する

環境変数の優先順位

Sequential Thinking MCP サーバーでは、環境変数を次の順序で優先します。

1. Cursor/Claude の設定から直接渡された環境変数
2. .env ファイルの環境変数（存在し、#1 が利用できない場合）
3. 任意の変数のデフォルト値

セットアップ

1. リポジトリをクローンします

2. 依存関係をインストールします：

   npm install
   

3. 次のいずれかの設定方法を選択します：

   方法 1：Cursor/Claude の設定で環境変数を使用する（推奨）

   推奨される方法は、Cursor または Claude Desktop の設定に環境変数を直接指定することです。こちらのほうが安全で、.env ファイルも不要です。

   • 設定を通じて環境変数を指定すると、サーバーは自動的にそれらを使用します。
   • 詳しい設定手順については、以下の「Cursor への追加」および「Claude Desktop への追加」のセクションを参照してください。

   方法 2：.env ファイルを使用する（代替方法）

   .env ファイルを使用したい場合、または Cursor/Claude を介さずにサーバーを直接実行する場合は、次の手順で作成できます：

   1. 秘密鍵を記載した .env ファイルを作成します：

      RECALL_PRIVATE_KEY=your_private_key_here
      RECALL_NETWORK=testnet
      RECALL_BUCKET_ALIAS=sequential-thinking-logs
      RECALL_LOG_PREFIX=sequential-
      

   2. .env ファイルを保護します：

      chmod 600 .env
      

   注：秘密鍵は「0x」プレフィックスの有無にかかわらず指定できます。どちらの形式も使用できます。

ツール

サーバーは次の MCP ツールを公開します：

ツール名	説明	パラメーター
sequentialthinking	思考を段階的に処理し、Recall に保存します	thought: String、nextThoughtNeeded: Boolean、thoughtNumber: Integer、totalThoughts: Integer、およびオプションのパラメーター
recallstatus	Recall 統合のステータスを取得します	check: Boolean
listsessions	すべての逐次的思考セッションを一覧表示します	includePortalLinks?: Boolean
getsession	特定の思考セッションを取得します	key: String

sequentialthinking

問題解決と分析のための、詳細で段階的な思考プロセスを実現します。

入力：

• thought（string）：現在の思考ステップ
• nextThoughtNeeded（boolean）：次の思考ステップが必要かどうか
• thoughtNumber（integer）：現在の思考番号
• totalThoughts（integer）：必要と見込まれる思考の総数
• isRevision（boolean、optional）：以前の思考を修正するかどうか
• revisesThought（integer、optional）：再検討する思考の番号
• branchFromThought（integer、optional）：分岐元となる思考の番号
• branchId（string、optional）：分岐識別子
• needsMoreThoughts（boolean、optional）：さらに思考が必要かどうか

出力： 最終的な思考が送信されると（nextThoughtNeeded = false）、ツールは次を返します：

• recallInfo：
  • txHash：Recall ネットワーク上のトランザクションハッシュ
  • success：保存が成功したかどうか
  • key：セッションファイル名
  • viewUrl：Recall ポータルでセッションを表示するための直接リンク

recallstatus

Recall 統合のステータスを取得します。

入力：

• check（boolean）：ステータスを確認するには true に設定します

出力：

• 初期化ステータス、バケットアドレス、バケットエイリアス、ログプレフィックスなど、Recall 統合に関する情報

listsessions

Recall バケットに保存されている、すべての逐次的思考セッションオブジェクトを一覧表示します。

入力：

• includePortalLinks（boolean、optional）：各セッションのポータルリンクを含めるかどうか

出力：

• 保存されているすべてのセッションファイルと、そのメタデータおよびオプションのポータルリンクの一覧

getsession

特定の逐次的思考セッションファイルの内容を取得します。

入力：

• key（string）：取得するセッションのキー／ファイル名

出力：

• 思考とメタデータをすべて含む、要求されたセッションファイルの完全な内容
• Recall ポータルでセッションを表示するためのポータルリンク

使用方法

Sequential Thinking ツールは、次の用途向けに設計されています。

• 複雑な問題を手順に分解する
• 修正の余地を残した計画と設計
• 方針の修正が必要になる可能性がある分析
• 当初は全体像が明確でない可能性がある問題
• 複数の手順にわたってコンテキストを維持する必要があるタスク
• 無関係な情報を除外する必要がある状況

ビルド

npm run build
npm run start

開発モード

npm run dev

開発時の重要な注意事項

MCP サーバーの開発時は、デバッグとログ出力のすべてに console.log() ではなく console.error() を使用してください。Claude Desktop アプリは stdout 経由でサーバーと通信するため、console.log() の記述があると通信に干渉し、JSON の解析エラーが発生します。

Cursor への追加

この MCP サーバーを Cursor に追加するには、次の手順に従ってください。

1. まず npm run build でプロジェクトをビルドします
2. Cursor で「Settings > MCP Servers」に移動します
3. 「Add Server」をクリックします
4. 次の設定でサーバーを構成します。
   • Name: Sequential Thinking MCP（または任意の名前）
   • Type: command
   • Command: node
   • Arguments: /path/to/sequential-thinking-recall/dist/index.js（実際のパスに置き換えてください）
   • Environment Variables:
     • RECALL_PRIVATE_KEY: 秘密鍵（「0x」プレフィックスの有無は問いません）
     • RECALL_NETWORK: testnet（必要に応じて mainnet）
     • RECALL_BUCKET_ALIAS: sequential-thinking-logs
     • RECALL_LOG_PREFIX: sequential-
5. 「Save」をクリックします

Cursor の設定での環境変数の使用

セキュリティを強化するため、ホームディレクトリにある .cursor/mcp.json ファイルを使用して Cursor を構成できます。

{
  "mcpServers": {
    "sequential-thinking-mcp": {
      "command": "node",
      "args": [
        "/Users/yourusername/sequential-thinking-recall/dist/index.js"
      ],
      "env": {
        "RECALL_PRIVATE_KEY": "your-private-key-here",
        "RECALL_NETWORK": "testnet",
        "RECALL_BUCKET_ALIAS": "sequential-thinking-logs",
        "RECALL_LOG_PREFIX": "sequential-"
      }
    }
  }
}

この方法を使うと、.env ファイルが不要になります。

Claude Desktop への追加

この MCP サーバーを Claude Desktop に追加するには、次の手順に従ってください。

1. まず npm run build でプロジェクトをビルドします

2. 次の場所にある Claude Desktop の設定ファイルを確認します。

   • macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows の場合：%APPDATA%\Claude\claude_desktop_config.json
   • Linux の場合：~/.config/Claude/claude_desktop_config.json

3. 次の内容で claude_desktop_config.json ファイルを作成または編集します。

   {
     "mcpServers": {
       "sequential-thinking-mcp": {
         "command": "node",
         "args": [
           "/path/to/sequential-thinking-recall/dist/index.js"
         ],
         "env": {
           "RECALL_PRIVATE_KEY": "your-private-key-here",
           "RECALL_NETWORK": "testnet",
           "RECALL_BUCKET_ALIAS": "sequential-thinking-logs",
           "RECALL_LOG_PREFIX": "sequential-"
         }
       }
     }
   }
   

4. /path/to/sequential-thinking-recall/dist/index.js を、コンパイル済みサーバーファイルの完全なパスに置き換えます。

   • 例：/Users/username/sequential-thinking-recall/dist/index.js

5. RECALL_PRIVATE_KEY は「0x」プレフィックスの有無を問わず指定できます。どちらの形式も使用できます。

6. 設定ファイルを保存し、Claude Desktop を再起動します

ライセンス

この MCP サーバーは MIT License の下でライセンスされています。つまり、MIT License の利用規約に従う限り、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルを参照してください。