インタラクティブMCP

Node.js/TypeScriptで実装されたMCPサーバー。LLMとユーザー間のインタラクティブな通信を容易にします。**注：**このサーバーは、通知やコマンドラインプロンプトを表示するためにユーザーのオペレーティングシステムに直接アクセスする必要があるため、MCPクライアント（Claude Desktop、VS Codeなど）と並行してローカルで実行されるように設計されています。

(注: このプロジェクトはまだ初期段階です。)

**概要を知りたいですか？**紹介ブログ記事をご覧ください： AIアシスタントの推測を阻止する - interactive-mcpのご紹介

ツール

このサーバーは、モデル コンテキスト プロトコル (MCP) を介して次のツールを公開します。

• request_user_input : ユーザーに質問し、回答を返します。定義済みのオプションを表示できます。

• message_complete_notification : 簡単な OS 通知を送信します。

• start_intensive_chat : 永続的なコマンドライン チャット セッションを開始します。

• ask_intensive_chat : アクティブな集中チャットセッション内で質問します。

• stop_intensive_chat : アクティブな集中チャットセッションを閉じます。

Related MCP server: MCP Server TypeScript Template

デモ

インタラクティブ機能のデモを次に示します。

使用シナリオ

このサーバーは、次のような LLM がローカル マシン上のユーザーと直接対話する必要があるシナリオに最適です。

• 対話型のセットアップまたは構成プロセス。

• コード生成または変更中にフィードバックを収集します。

• ペアプログラミングにおける指示の明確化やアクションの確認。

• LLM 操作中にユーザー入力または確認を必要とするワークフロー。

クライアント構成

このセクションではinteractive-mcpサーバーを使用するように MCP クライアントを構成する方法について説明します。

デフォルトでは、ユーザープロンプトは30秒後にタイムアウトします。クライアントの設定時に、コマンドラインフラグをargs配列に直接追加することで、タイムアウトや無効化ツールなどのサーバーオプションをカスタマイズできます。

npxコマンドが使用可能であることを確認してください。

Claude Desktop / Cursor での使用

次の最小限の構成をclaude_desktop_config.json (Claude Desktop) またはmcp.json (Cursor) に追加します。

{
  "mcpServers": {
    "interactive": {
      "command": "npx",
      "args": ["-y", "interactive-mcp"]
    }
  }
}

カスタムタイムアウト（30秒）の例:

{
  "mcpServers": {
    "interactive": {
      "command": "npx",
      "args": ["-y", "interactive-mcp", "-t", "30"]
    }
  }
}

VS Codeでの使用

ユーザー設定 (JSON) ファイルまたは.vscode/mcp.jsonに次の最小限の構成を追加します。

{
  "mcp": {
    "servers": {
      "interactive-mcp": {
        "command": "npx",
        "args": ["-y", "interactive-mcp"]
      }
    }
  }
}

macOSの推奨事項

macOS でデフォルトのTerminal.appを使用してよりスムーズなエクスペリエンスを得るには、次のプロファイル設定を検討してください。

• （シェルタブ）： 「シェルの終了時」 （ターミナル > 設定 > プロファイル > [あなたのプロファイル] > シェル）で、 **「シェルが正常に終了した場合は閉じる」または「ウィンドウを閉じる」**を選択します。これにより、MCPサーバーの起動時と停止時のウィンドウ管理が容易になります。

開発セットアップ

このセクションは、主にサーバーの修正や貢献を希望する開発者向けです。MCPクライアントでサーバーを使用するだけの場合は、上記の「クライアント設定」セクションをご覧ください。

前提条件

• **Node.js:**バージョンの互換性についてはpackage.json確認してください。

• **pnpm:**パッケージ管理に使用します。Node.js をインストールした後、 npm install -g pnpmでインストールしてください。

インストール（開発者）

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

   git clone https://github.com/ttommyth/interactive-mcp.git
   cd interactive-mcp

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

   pnpm install

アプリケーションの実行（開発者）

pnpm start

コマンドラインオプション

interactive-mcpサーバーは以下のコマンドラインオプションを受け入れます。これらのオプションは通常、MCP クライアントの JSON 設定でargs配列に直接追加することで設定します（「クライアント設定」の例を参照）。

**例:**クライアント構成args配列に複数のオプションを設定する:

// Example combining options in client config's "args":
"args": [
  "-y", "interactive-mcp",
  "-t", "30", // Set timeout to 30 seconds
  "--disable-tools", "message_complete_notification,intensive_chat" // Disable notifications and intensive chat
]

開発コマンド

• ビルド: pnpm build

• リント: pnpm lint

• フォーマット: pnpm format

インタラクションの指針

この MCP サーバーと対話する場合 (たとえば、LLM クライアントとして)、明確さを確保し、予期しない変更を減らすために、次の原則に従ってください。

• **インタラクションの優先順位付け:**提供されている MCP ツール ( request_user_input 、 start_intensive_chatなど) を頻繁に利用して、ユーザーとやり取りします。

• 明確化を求める：要件、指示、または状況が不明瞭な場合は、先に進む前に必ず明確にするための質問をしてください。決めつけは禁物です。

• **アクションの確認:**重要なアクション (ファイルの変更、複雑なコマンドの実行、アーキテクチャ上の決定など) を実行する前に、ユーザーと計画を確認します。

• **オプションの提供:**可能な場合は常に、MCP ツールを通じて事前定義されたオプションをユーザーに提示し、迅速な意思決定を促進します。

これらの指示は、次のようにして LLM クライアントに提供できます。

# Interaction

- Please use the interactive MCP tools
- Please provide options to interactive MCP if possible

# Reduce Unexpected Changes

- Do not make assumption.
- Ask more questions before executing, until you think the requirement is clear enough.

貢献

貢献を歓迎します！標準的な開発プラクティスに従ってください。（詳細は後日追加されます）。

ライセンス

MIT (詳細についてはLICENSEファイルを参照してください - 該当する場合、またはライセンスを直接指定してください)。