Interactive MCP
インタラクティブ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: Interactive Feedback MCP
デモ
インタラクティブ機能のデモを次に示します。
通常の質問 | 完了通知 |
|
|
集中チャット開始 | 集中チャット終了 |
|
|
使用シナリオ
このサーバーは、次のような 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"]
}
}
}特定のバージョン
{
"mcpServers": {
"interactive": {
"command": "npx",
"args": ["-y", "interactive-mcp@1.9.0"]
}
}
}カスタムタイムアウト(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でインストールしてください。
インストール(開発者)
リポジトリをクローンします。
git clone https://github.com/ttommyth/interactive-mcp.git cd interactive-mcp依存関係をインストールします:
pnpm install
アプリケーションの実行(開発者)
pnpm startコマンドラインオプション
interactive-mcpサーバーは以下のコマンドラインオプションを受け入れます。これらのオプションは通常、MCP クライアントの JSON 設定でargs配列に直接追加することで設定します(「クライアント設定」の例を参照)。
オプション | エイリアス | 説明 |
|
| ユーザー入力プロンプトのデフォルトのタイムアウト(秒単位)を設定します。デフォルトは 30 秒です。 |
|
| 特定のツールまたはグループ(カンマ区切りのリスト)を無効にします。サーバーがそれらを宣伝したり登録したりすることを防ぎます。オプション: |
**例:**クライアント構成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ファイルを参照してください - 該当する場合、またはライセンスを直接指定してください)。
Available Tools
5 toolsask_intensive_chatA
Inputs: question (required), sessionId (required), predefinedOptions.
message_complete_notificationA
Inputs: message (required), projectName (required).
request_user_inputA
Inputs: message (required), projectName (required), predefinedOptions.
start_intensive_chatA
Inputs: sessionTitle (required).
stop_intensive_chatA
Inputs: sessionId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clear, distinct purpose: start, ask, and stop intensive chat sessions; request general user input; and notify completion. No overlap, as ask_intensive_chat is contextual within an active session, while request_user_input is standalone. The descriptions further clarify their distinct use cases.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., start_intensive_chat, request_user_input). The naming is predictable and logically groups related actions (start/ask/stop for intensive chat). No mixing of conventions.
With 5 tools, the server is well-scoped for its purpose of managing interactive user input and notifications. Each tool is necessary and there is no bloat. This count is ideal for such a focused domain.
The tool set covers the full lifecycle of an intensive chat session (start, ask questions, stop), plus a general user input tool and a completion notification. There are no obvious gaps for the stated purpose of gathering user input and signaling completion.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for AI dialogue using various LLM models via AceDataCloud
Impri MCP server — human-in-the-loop approval inbox for AI agents
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Related MCP Servers
- AlicenseBqualityDmaintenanceA secure terminal execution server that enables controlled command execution with security features and resource limits via the Model Context Protocol (MCP).14 npm11MIT
- AlicenseAqualityDmaintenanceA MCP server that enables human-in-the-loop workflow in AI-assisted development tools by allowing users to run commands, view their output, and provide textual feedback directly to the AI assistant.11,701MIT
- AlicenseAqualityDmaintenanceA Node.js/TypeScript MCP server that facilitates interactive communication between LLMs and users, allowing AI assistants to request user input, display notifications, and manage command-line chat sessions.51MIT
- AlicenseNot gradedqualityDmaintenanceA cross-platform MCP server that provides native popup windows for AI agents to gather user feedback, input, and safety confirmations. It enables agents to present interactive questionnaires and secure confirmation prompts for sensitive operations like file deletion or code execution.13MIT



