Mcp Interactive

by ivan-mezentsev

284 downloads
Not rated
GitHub

About

This MCP server enhances LLM coordination, offering greater control and predictability, and significantly reduces billable requests by minimizing user interactions within a single task.

Details

Author
ivan-mezentsev
Downloads
284
Categories
Communication, AI, Other

- Electron-based interactive pop-up for user prompts.
- ask_user tool with support for Markdown and predefined options.
- Configurable timeout: defaults to 60 seconds, adjustable via -t.
- Reduces billable requests by consolidating user interactions.
- Compatible with Trae IDE and Claude for Mac.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Interactive
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package locally via npm or run it via npx. Configure the MCP server in your client settings with the appropriate command and arguments, including an optional -t timeout (in seconds). The server exposes a single tool, ask_user, which accepts a project name, message (supports Markdown), and optional predefined options.

ask_user

Prompts the user with a question via a pop-up command prompt and awaits their interactive response.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp interactive": {
            "interactive": {
                "command": "npx",
                "args": [
                    "mcp-interactive",
                    "-t",
                    "300"
                ]
            }
        }
    }
}

McpServers

{
    "interactive": {
        "command": "npx",
        "args": [
            "mcp-interactive",
            "-t",
            "300"
        ]
    }
}

Enables communication between an LLM and a user through an interactive Electron interface.

An interactive MCP (Model Context Protocol) server with an Electron interface for user interaction.

This MCP server enhances LLM coordination, offering greater control and predictability, and significantly reduces billable requests by minimizing user interactions within a single task.

For a detailed history of changes, see theChangelog.

- Tested and Confirmed:

- Trae IDE
- Claude for Mac
- augment code
- Cursor IDE
- VSCode with Copilot

ask_user- Prompts the user with a question via a pop-up command prompt and awaits their interactive response.

{ "type": "object", "properties": { "projectName": { "type": "string", "description": "Identifies the context/project making the request" }, "message": { "type": "string", "description": "The specific question for the user. Supports Markdown formatting." }, "predefinedOptions": { "type": "array", "items": { "type": "string" }, "description": "Predefined options for the user to choose from (optional)" } }, "required": [ "projectName", "message" ] }
{ "mcpServers": { "interactive": { "command": "npx", "args": [ "mcp-interactive", "-t", "300" ] } } }
{ "mcpServers": { "interactive": { "command": "node", "args": [ "/path/to/project/mcp-interactive/index.js", "-t", "300" ] } } }

System Prompt Recommendations forVisual Studio Code,Cursor IDE

## Decision Making - Ambiguous tasks: ALWAYS clarify using mcp_interactive_ask_user tool - Requires decisions: ALWAYS clarify using mcp_interactive_ask_user tool ## Code Development - Final confirmation: MUST ask user if all requirements from specification are completed using mcp_interactive_ask_user tool with work report ## Final gate - Before ANY final answer (after actions/edits/checks), it is MANDATORY to call mcp_interactive_ask_user with a report on the work done and the option ["Yes, everything is OK"]. - If the answer is not "Yes, everything is OK" — continue working until the comments are resolved and repeat every time mcp_interactive_ask_user. - There are no exceptions (including minor edits).

Example of "Human In The Loop" mode in chat ofVisual Studio Code

Can you check the docs and explain how the project works? #interactive

System Prompt Recommendations forTrae IDE

This section outlines recommended guidelines for system prompts or rules for LLMs to ensure optimal interaction and task execution.

## Decision Making - Ambiguous tasks: ALWAYS clarify using ask_user tool via MCP - Requires decisions: ALWAYS clarify using ask_user tool via MCP ## Code Development - Final confirmation: MUST ask user if all requirements from specification are completed using ask_user tool via MCP with work report ## Final gate - Before ANY final answer (after actions/edits/checks), it is MANDATORY to call ask_user with a report on the work done and the option ["Yes, everything is OK"]. - If the answer is not "Yes, everything is OK" — continue working until the comments are resolved and repeat every time ask_user. - There are no exceptions (including minor edits).

- --timeoutor-t(seconds): Specifies the waiting time for the user's response dialog. If no response is received within this period, the reply "User did not reply: Timeout occurred." will be sent.

- Ensure the current version of Node.js is installed
- Try reinstalling dependencies by running:npm install

Timeout issues for answer (progressbar):

- Increase timeout value using-tparameter
- Default timeout is 60 seconds, adjust as needed

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate and follow the existing code style.

If you encounter any problems or have questions, pleaseopen an issueon GitHub.

This project includes a local copy ofmarked.js(marked.min.js) for Markdown parsing functionality. Marked is licensed under the MIT License and is maintained by the Marked.js team and contributors.

- marked.js: MIT License - Copyright (c) 2018+, MarkedJS contributors

Secure audio transcription meets AI. Connect Alice recordings to Claude, ChatGPT, Gemini, and more.

An MCP server client for the Agent-to-Agent (A2A) protocol, enabling LLMs to interact with A2A agents.

An advanced AI companion with emotional intelligence and vector database integration.

A bridge server connecting Claude Desktop with the chakoshi moderation API for content safety.

An MCP server to interact with OpenAI's ChatGPT API for conversational AI and text generation.

Local-first MCP server that puts your own LINE and Telegram chats behind one data layer — a daemon on your machine logs in with your own account, stores messages to JSONL + SQLite/FTS5, and exposes them to MCP clients like Claude Code. Not an npx one-liner: you clone the repo and run the daemon yourself.

Sends notifications from Claude Code with customizable sounds and cross-platform support.

An AI-powered email intelligence platform that integrates with Gmail and OpenAI. It can be run as a CLI tool or deployed on AWS Lambda for enhanced capabilities.

Integrate with Google's Gemini AI models for various tasks.

An intelligent, LLM-powered email assistant using the Nylas v3 API.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.