# Mcp Interactive

> An interactive MCP (Model Context Protocol) server with a graphical interface for user interaction.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ivan-mezentsev-mcp-interactive`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ivan-mezentsev](https://agentstack.voostack.com/s/ivan-mezentsev)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ivan-mezentsev](https://github.com/ivan-mezentsev)
- **Source:** https://github.com/ivan-mezentsev/mcp-interactive

## Install

```sh
agentstack add mcp-ivan-mezentsev-mcp-interactive
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Interactive

[](https://www.npmjs.com/package/mcp-interactive) [](https://www.npmjs.com/package/mcp-interactive)
[](https://opensource.org/licenses/MIT)
[](https://github.com/ivan-mezentsev/mcp-interactive/issues)

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

## Key Features

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 the [Changelog](CHANGELOG.md).

## Demo

## Compatibility

- **Tested and Confirmed:**
  - Trae IDE
  - Claude for Mac
  - augment code
  - Cursor IDE
  - VSCode with Copilot

## Available Tools

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

**Input Schema:**

```json
{
  "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"
  ]
}
```

## Installation

### Using npx

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

### Local Installation

Install dependencies:

```bash
npm install
```

Configure MCP server:

```json
{
  "mcpServers": {
    "interactive": {
      "command": "node",
      "args": [
        "/path/to/project/mcp-interactive/index.js",
        "-t",
        "300"
      ]
    }
  }
}
```

## System Prompt Recommendations for ***Visual Studio Code***, ***Cursor IDE***

```Markdown
## 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 of ***Visual Studio Code***

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

## System Prompt Recommendations for ***Trae IDE***

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

```Markdown
## 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).
```

## Command Line Options

- `--timeout` or `-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.

## Troubleshooting

### Common Issues

**Electron not starting:**

- 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 `-t` parameter
- Default timeout is 60 seconds, adjust as needed

## Contributing

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.

## Support

If you encounter any problems or have questions, please [open an issue](https://github.com/ivan-mezentsev/mcp-interactive/issues) on GitHub.

## Dependencies

This project includes a local copy of [marked.js](https://github.com/markedjs/marked) (`marked.min.js`) for Markdown parsing functionality. Marked is licensed under the MIT License and is maintained by the Marked.js team and contributors.

## License

MIT

### Third-Party Licenses

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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ivan-mezentsev](https://github.com/ivan-mezentsev)
- **Source:** [ivan-mezentsev/mcp-interactive](https://github.com/ivan-mezentsev/mcp-interactive)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ivan-mezentsev-mcp-interactive
- Seller: https://agentstack.voostack.com/s/ivan-mezentsev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.