Skip to main content
Glama
Sign In
deenesjakoruzh

Interactive MCP

by ttommyth
npmGitHub
TypeScript
MIT License
116
46
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue
Integrations

  • Provides cross-platform support for Linux environments, allowing LLMs to interact directly with users on their local Linux machines.

  • Supports running on macOS with specific recommendations for Terminal.app settings to ensure a smooth experience with the interactive MCP server.

  • Implements the Model Context Protocol (MCP) server in Node.js, allowing seamless integration with the local operating system for displaying notifications and command-line prompts.

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

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 : Закрывает активный сеанс интенсивного чата.

Демо

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

Обычный вопросУведомление о завершении
Начало интенсивного чатаКонец интенсивного чата

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

Этот сервер идеально подходит для сценариев, в которых 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 , если применимо, или укажите лицензию напрямую).

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Задавайте вопросы пользователям из вашей LLM! interactive-mcp: локальный кроссплатформенный сервер MCP для интерактивных подсказок, чата и уведомлений.

  1. Инструменты
    1. Демо
      1. Сценарии использования
        1. Конфигурация клиента
          1. Использование с Claude Desktop / Курсор
          2. Использование с VS Code
        2. Настройка разработки
          1. Предпосылки
          2. Установка (Разработчики)
          3. Запуск приложения (разработчики)
        3. Команды развития
          1. Руководящие принципы взаимодействия
            1. Внося вклад
              1. Лицензия

                Related MCP Servers

                • mcp-server-commands

                  g0t4
                  A
                  security
                  A
                  license
                  A
                  quality
                  An MCP server to run commands.
                  Last updated -
                  2
                  446
                  138
                  TypeScript
                  MIT License
                  • Apple

                • MCP Terminal Server

                  RinardNick
                  A
                  security
                  A
                  license
                  A
                  quality
                  A secure terminal execution server that enables controlled command execution with security features and resource limits via the Model Context Protocol (MCP).
                  Last updated -
                  1
                  12
                  1
                  JavaScript
                  MIT License
                  • Apple

                • Terminal MCP Server

                  theailanguage
                  -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that allows AI assistants like Claude to execute terminal commands on the user's computer and return the output, functioning like a terminal through AI.
                  Last updated -
                  7
                  Python
                  • Apple

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/ttommyth/interactive-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server