Interactive MCP

🚀 interactive-mcp

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

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

概要を知りたいですか？ 紹介ブログ記事をチェックしてください: Stop Your AI Assistant From Guessing — Introducing interactive-mcp

Modlによってホストされており、Modlチームによるコミットや変更は互換性を確保するためのものです。

🚀 クイックスタート

このサーバーは、大規模言語モデル（LLM）がユーザーと直接対話するためのMCPサーバーです。ローカルでMCPクライアントと一緒に実行する必要があります。

デモビデオ

✨ 主な機能

このサーバーは、Model Context Protocol (MCP) を介して次のツールを公開します。

• request_user_input: ユーザーに質問をし、回答を返します。事前定義されたオプションを表示できます。
• message_complete_notification: 単純なOS通知を送信します。
• start_intensive_chat: 永続的なコマンドラインチャットセッションを開始します。
• ask_intensive_chat: アクティブな集中チャットセッション内で質問をします。
• stop_intensive_chat: アクティブな集中チャットセッションを閉じます。

💻 使用例

基本的な使用法

このサーバーの基本的な使用法を示すために、クライアントの設定例を示します。

Claude Desktop / Cursor での使用

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

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

VS Code での使用

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

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

高度な使用法

カスタムタイムアウトやツールの無効化などの高度な設定を行うことができます。

カスタムタイムアウト (30秒) の例:

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

複数のオプションを設定する例:

// クライアント設定の "args" でオプションを組み合わせる例
"args": [
  "-y", "interactive-mcp",
  "-t", "30", // タイムアウトを30秒に設定
  "--disable-tools", "message_complete_notification,intensive_chat" // 通知と集中チャットを無効化
]

📚 ドキュメント

使用シナリオ

このサーバーは、LLMがユーザーと直接対話する必要があるシナリオに最適です。

• 対話型のセットアップまたは構成プロセス。
• コード生成または変更中のフィードバック収集。
• ペアプログラミングにおける指示の明確化またはアクションの確認。
• LLM操作中にユーザー入力または確認が必要な任意のワークフロー。

クライアント設定

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

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

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

macOSの推奨設定

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

• (シェルタブ): "シェルが正常に終了したとき" (ターミナル > 設定 > プロファイル > [あなたのプロファイル] > シェル) の下で、"シェルが正常に終了した場合は閉じる" または "ウィンドウを閉じる" を選択します。これにより、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 サーバーは、次のコマンドラインオプションを受け付けます。これらは通常、クライアントのJSON設定の args 配列に直接追加することで構成されます（「クライアント設定」の例を参照）。

開発コマンド

• ビルド: pnpm build
• リント: pnpm lint
• フォーマット: pnpm format

対話の指針

このMCPサーバーと対話する際（例：LLMクライアントとして）は、明確さを確保し、予期しない変更を減らすために、次の原則に従ってください。

• 対話を優先する: 提供されたMCPツール (request_user_input, start_intensive_chat など) を頻繁に利用してユーザーとやり取りします。
• 明確化を求める: 要件、指示、またはコンテキストが不明な場合は、常に 進む前に明確化の質問をしてください。仮定をしないでください。
• アクションを確認する: 重要なアクション（ファイルの変更、複雑なコマンドの実行、またはアーキテクチャ上の決定など）を実行する前に、ユーザーと計画を確認してください。
• オプションを提供する: 可能な限り、MCPツールを通じてユーザーに事前定義されたオプションを提示して、迅速な決定を容易にします。

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

# 対話

- 対話型MCPツールを使用してください
- 可能であれば、対話型MCPにオプションを提供してください

# 予期しない変更を減らす

- 仮定をしないでください。
- 要件が十分に明確になるまで、実行前により多くの質問をしてください。

🤝 貢献

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

📄 ライセンス

MIT（該当する場合は LICENSE ファイルを参照するか、直接ライセンスを指定してください）。