AskMeMCP - Human-in-the-Loop MCP Server

AskMeMCP is a Model Context Protocol (MCP) server that enables AI assistants to request human input through a web interface. It implements multiple interactive tools (ask-one-question, ask-multiple-choice, challenge-hypothesis, choose-next), allowing MCP clients like Claude Code to pause execution and wait for human responses.

Features

• stdio Transport: Direct integration with Claude Code and other MCP clients

• Self-Contained Server: Serves Angular UI statically - no separate UI server needed

• Dynamic Port Allocation: Automatically finds available port if default is in use

• Automatic Browser Opening: Opens UI automatically when requests arrive

• Real-time Updates: Server-Sent Events for live communication

• Multiple Tool Types: Single questions, multiple choice, hypothesis challenges, and decision workflows

Installation

Option 1: Using npx (No Installation Required)

You can run Ask-Me MCP directly using npx without installing it globally:

Note: The first time you run this, npx will ask for confirmation to install the package temporarily. To skip this confirmation, use:

Option 2: Global Installation

Configuration for Different Clients

Claude Desktop App

Add to your Claude configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Claude Code

Using the CLI:

Or manually add to your Claude Code configuration:

• macOS: ~/Library/Application Support/Claude/claude_code_config.json

• Windows: %APPDATA%\Claude\claude_code_config.json

• Linux: ~/.config/Claude/claude_code_config.json

Cursor

Add to your Cursor settings (in .cursor/mcp_settings.json in your project root):

VS Code with Continue or Similar Extensions

For VS Code extensions that support MCP, add to your extension's configuration:

Port Configuration

The server has two port behaviors:

1. Auto-discovery (default): Finds available port starting from 3000

   npx --yes ask-me-mcp

2. Fixed port: Uses exact port specified with --port (fails if port is in use)

   npx --yes ask-me-mcp --port 8080

For Claude Code configuration with fixed port:

Option 3: Build from Source

Add to your Claude Code configuration:

Usage

Once configured, you can use the available tools in Claude Code:

ask-one-question Tool

ask-multiple-choice Tool

All requests will appear in the web UI where you can provide responses. For multiple choice questions, you can select multiple options and add comments to each choice.

Architecture

• askme-server: stdio MCP server with embedded HTTP bridge for browser communication

• askme-ui: Angular 20+ frontend with reactive UI using signals

• askme-shared: Shared TypeScript types for frontend-backend communication

Development

Troubleshooting

Connection Issues with Claude Code

If you see "Connection failed" errors:

1. Enable Debug Mode: Run with debug logging to see what's happening:

   ASK_ME_MCP_DEBUG=1 claude --debug

2. Check the Server: Test if the server runs correctly:

   npx --yes ask-me-mcp --help

3. Port Conflicts: If port 3000 is in use, specify a different port:

   claude mcp add ask-me npx --yes ask-me-mcp --port 8080

4. Manual Test: Run the server directly to see any errors:

   npx --yes ask-me-mcp

Common Issues

• First Time Confirmation: The first run of npx ask-me-mcp may ask for confirmation. Use npx --yes to skip this.

• Port Already in Use: The server automatically finds an available port, but you can specify one with --port

• Browser Not Opening: If the browser doesn't open automatically, manually navigate to the port shown in debug logs

License

MIT