Skip to main content
Glama
Interactive MCP

Interactive MCP

интерактивный-mcp

npm-версия npm-загрузки значок кузнеца Лицензия GitHub стиль кода: симпатичнее Платформы Последний коммит GitHub

Скриншот 2025-05-13 213745

MCP-сервер, реализованный в Node.js/TypeScript, облегчающий интерактивное общение между LLM и пользователями. Примечание: этот сервер предназначен для локальной работы вместе с клиентом MCP (например, Claude Desktop, VS Code), поскольку ему необходим прямой доступ к операционной системе пользователя для отображения уведомлений и запросов командной строки.

(Примечание: этот проект находится на ранней стадии.)

Хотите краткий обзор? Ознакомьтесь с вводной записью в блоге: 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 : Закрывает активный сеанс интенсивного чата.

Related MCP server: Interactive Feedback MCP

Демо

Вот демонстрации интерактивных функций:

Обычный вопрос

Уведомление о завершении

Демо-версия обычного вопроса

Демонстрация уведомления о завершении

Начало интенсивного чата

Конец интенсивного чата

Начать интенсивную демонстрацию чата

Завершить интенсивную демонстрацию чата

Сценарии использования

Этот сервер идеально подходит для сценариев, в которых LLM необходимо напрямую взаимодействовать с пользователем на его локальном компьютере, например:

  • Интерактивные процессы настройки или конфигурирования.

  • Сбор отзывов во время генерации или модификации кода.

  • Уточнение инструкций или подтверждение действий в парном программировании.

  • Любой рабочий процесс, требующий ввода данных или подтверждения пользователя во время работы LLM.

Конфигурация клиента

В этом разделе объясняется, как настроить клиенты MCP для использования сервера interactive-mcp .

По умолчанию запросы пользователя будут отсутствовать по истечении 30 секунд. Вы можете настроить параметры сервера, такие как тайм-аут или отключенные инструменты, добавив флаги командной строки непосредственно в массив args при настройке клиента.

Убедитесь, что у вас доступна команда npx .

Использование с Claude Desktop / Курсор

Добавьте следующую минимальную конфигурацию в файл 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 рассмотрите следующую настройку профиля:

  • (Вкладка Shell): В разделе «При выходе из оболочки» ( Терминал > Настройки > Профили > [Ваш профиль] > Shell ) выберите «Закрыть, если оболочка завершилась нормально» или «Закрыть окно» . Это помогает управлять окнами при запуске и остановке сервера MCP.

Настройка разработки

Этот раздел в первую очередь предназначен для разработчиков, желающих изменить или внести свой вклад в сервер. Если вы просто хотите использовать сервер с клиентом MCP, см. раздел «Конфигурация клиента» выше.

Предпосылки

  • Node.js: Проверьте package.json на совместимость версий.

  • pnpm: Используется для управления пакетами. Устанавливается через npm install -g pnpm после установки Node.js.

Установка (Разработчики)

  1. Клонируйте репозиторий:

    git clone https://github.com/ttommyth/interactive-mcp.git
    cd interactive-mcp
  2. Установить зависимости:

    pnpm install

Запуск приложения (разработчики)

pnpm start

Параметры командной строки

Сервер interactive-mcp принимает следующие параметры командной строки. Обычно их следует настраивать в настройках JSON вашего клиента MCP, добавляя их непосредственно в массив args (см. примеры «Конфигурация клиента»).

Вариант

Псевдоним

Описание

--timeout

-t

Устанавливает тайм-аут по умолчанию (в секундах) для запросов на ввод данных пользователем. По умолчанию 30 секунд.

--disable-tools

-d

Отключает определенные инструменты или группы (список, разделенный запятыми). Запрещает серверу рекламировать или регистрировать их. Параметры: request_user_input , message_complete_notification , intensive_chat .

Пример: установка нескольких параметров в массиве 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 tools
ask_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

    A4.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      5
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      13
      MIT