Interactive MCP

🚀 interactive-mcp

interactive-mcp 是一個用 Node.js/TypeScript 實現的 MCP 服務器，它能促進大語言模型（LLMs）與用戶之間的交互式通信。該服務器需要與 MCP 客戶端（如 Claude Desktop、VS Code）在本地一起運行，因為它需要直接訪問用戶的操作系統，以顯示通知和命令行提示。

由 Modl 託管，Modl 團隊進行的任何提交或更改都是為了確保兼容性

注意：本項目尚處於早期階段。

想快速瞭解？ 查看介紹博客文章：Stop Your AI Assistant From Guessing — Introducing interactive-mcp

🚀 快速開始

本服務器通過模型上下文協議（MCP）提供了以下工具，可促進大語言模型與用戶之間的交互式通信：

• request_user_input：向用戶提問並返回用戶的答案，還可以顯示預定義的選項。
• message_complete_notification：發送簡單的操作系統通知。
• start_intensive_chat：啟動一個持久的命令行聊天會話。
• ask_intensive_chat：在活躍的密集聊天會話中提問。
• stop_intensive_chat：關閉活躍的密集聊天會話。

演示視頻

✨ 主要特性

交互式展示

適用場景廣泛

本服務器非常適合大語言模型需要在本地機器上直接與用戶交互的場景，例如：

• 交互式設置或配置過程。
• 在代碼生成或修改期間收集反饋。
• 在結對編程中澄清指令或確認操作。
• 大語言模型操作期間任何需要用戶輸入或確認的工作流程。

📦 安裝指南

開發環境準備

• 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

💻 使用示例

客戶端配置

本部分介紹如何配置 MCP 客戶端以使用 interactive-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 獲得更流暢的體驗，可考慮進行以下配置：

• （Shell 選項卡）：在 "當 shell 退出時"（終端 > 設置 > 配置文件 > [你的配置文件] > Shell）中，選擇 "如果 shell 正常退出則關閉" 或 "關閉窗口"。這有助於在 MCP 服務器啟動和停止時管理窗口。

運行應用程序（開發者）

pnpm start

命令行選項

interactive-mcp 服務器接受以下命令行選項，這些選項通常應通過在 MCP 客戶端的 JSON 設置中直接添加到 args 數組來進行配置（參見“客戶端配置”示例）。

示例：在客戶端配置的 args 數組中設置多個選項：

// 在客戶端配置的 "args" 中組合選項的示例
"args": [
  "-y", "interactive-mcp",
  "-t", "30", // 設置超時時間為 30 秒
  "--disable-tools", "message_complete_notification,intensive_chat" // 禁用通知和密集聊天
]

📚 詳細文檔

開發命令

• 構建：pnpm build
• 代碼檢查：pnpm lint
• 代碼格式化：pnpm format

交互指導原則

當與這個 MCP 服務器交互時（例如作為大語言模型客戶端），請遵循以下原則，以確保交互清晰並減少意外更改：

• 優先交互：經常使用提供的 MCP 工具（如 request_user_input、start_intensive_chat 等）與用戶進行交互。
• 尋求澄清：如果需求、說明或上下文不明確，在繼續操作之前，務必詢問澄清問題，不要進行假設。
• 確認操作：在執行重要操作（如修改文件、運行復雜命令或做出架構決策）之前，與用戶確認計劃。
• 提供選項：儘可能通過 MCP 工具向用戶提供預定義的選項，以便於快速決策。

你可以向大語言模型客戶端提供如下說明：

# 交互

- 請使用交互式 MCP 工具
- 如有可能，請為交互式 MCP 提供選項

# 減少意外更改

- 不要進行假設。
- 在執行之前多問問題，直到你認為需求足夠清晰。

🤝 貢獻代碼

歡迎貢獻代碼！請遵循標準的開發實踐（後續可添加更多詳細信息）。

📄 許可證

本項目採用 MIT 許可證（有關詳細信息，請參閱 LICENSE 文件；如果適用，也可直接指定許可證）。