Package Exports

mcp-interactive
mcp-interactive/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-interactive) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

MCP Interactive

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.

Demo

Compatibility

Tested and Confirmed:
- Trae IDE
- Claude for Mac
Currently Not Supported (due to module import limitations within the Electron framework):
- 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:

{
  "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

Local Installation

Install dependencies:

npm install

Configure MCP server:

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

Using npx

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

System Prompt Recommendations

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

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 Node.js version 16+ is installed
Try reinstalling dependencies: npm install
Check if Electron is properly installed: npx electron --version

Module import errors in some IDEs:

This is a known limitation with Cursor IDE and VSCode with Copilot
Use Trae IDE or Claude for Mac for full compatibility

Timeout issues:

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 on GitHub.

Dependencies

This project includes a local copy of marked.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.

License

MIT

mcp-interactive