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 文件；如果适用，也可直接指定许可证）。