AskMeMCP - Servidor MCP Human-in-the-Loop

AskMeMCP es un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de inteligencia artificial solicitar información humana a través de una interfaz web. Implementa múltiples herramientas interactivas(pregunta-una-pregunta, pregunta-múltiple-elección, desafío-hipótesis, elegir-siguiente), permitiendo a los clientes MCP como Claude Code pausar la ejecución y esperar las respuestas humanas.

Características

• transporte stdio: Integración directa con Claude Code y otros clientes MCP
• Servidor autónomo: Sirve Angular UI estáticamente - no se necesita un servidor UI separado
• Asignación dinámica de puertos: Encuentra automáticamente el puerto disponible si el predeterminado está en uso
• Apertura automática del navegador: Abre la interfaz de usuario automáticamente cuando llegan las solicitudes
• Actualizaciones en tiempo real: Eventos enviados por el servidor para comunicación en directo
• Múltiples tipos de herramientas: Preguntas individuales, de opción múltiple, desafíos de hipótesis y flujos de trabajo de decisión

Instalación

Opción 1: Uso de npx (no requiere instalación)

Puede ejecutar Ask-Me MCP directamente utilizando npx sin instalarlo globalmente:

npx ask-me-mcp

Nota: La primera vez que lo ejecute, npx le pedirá confirmación para instalar el paquete temporalmente. Para omitir esta confirmación, utilice

npx --yes ask-me-mcp

Opción 2: Instalación global

npm install -g ask-me-mcp ask-me-mcp

Configuración para diferentes clientes

Claude Desktop App

Añada a su archivo de configuración Claude

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": {"ask-me": { "command": "npx", "args": ["--yes", "ask-me-mcp"] } }

Claude Code

Usando la CLI:

claude mcp add askme -- npx -y ask-me-mcp

O añadiendo manualmente a su configuración Claude Code:

• macOS: ~/Library/Application Support/Claude/claude_code_config.json
• Windows: %APPDATA%\Claude\claude_code_config.json
• Linux: ~/.config/Claude/claude_code_config.json

{"mcpServers": {"ask-me": { "command": "npx", "args": ["--yes", "ask-me-mcp"] } }

Cursor

Añada a la configuración de su Cursor (en .cursor/mcp_settings.json en la raíz de su proyecto):

{ "mcpServers": { "ask-me": { "command": "npx", "args": ["--yes", "ask-me-mcp"] } }

VS Code con extensiones Continue o similares

Para las extensiones de VS Code que soportan MCP, añada a la configuración de su extensión

{ "mcpServers": { "ask-me": { "command": "npx", "args": ["--yes", "ask-me-mcp"] } }

Configuración de puertos

El servidor tiene dos comportamientos de puerto:

1. Auto-discovery (por defecto): Encuentra el puerto disponible a partir de 3000

   npx --yes ask-me-mcp

2. Puerto fijo: Utiliza el puerto exacto especificado con --port (falla si el puerto está en uso)

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

Para la configuración de Claude Code con puerto fijo:

{ "mcpServers": { "ask-me": { "command": "npx", "args": ["--yes", "ask-me-mcp", "--port", "8080"] } }

Opción 3: Construir desde el código fuente

# Clonar el repositorio git clone https://github.com/yourusername/AskMeMCP.git cd AskMeMCP # Instalar dependencias npm install # Construir todos los proyectos npm run build # Configurar Claude Code con la ruta completa

Añada a su configuración Claude Code:

{ "mcpServers": { "ask-me": { "command": "node", "args": ["/full/path/to/AskMeMCP/dist/askme-server/main.js"] } }

Uso

Una vez configurado, puede utilizar las herramientas disponibles en Claude Code:

ask-one-question Herramienta

Utilice la herramienta ask-one-question para preguntarme cuál es mi color favorito

herramienta ask-multiple-choice

Utilice la herramienta de respuesta múltiple con estas preguntas: { "questions": [ { "text": "¿A qué entornos de despliegue deberíamos dirigirnos?", "options": ["Development", "Staging", "Production"] }, { "text": "¿Qué características deberían incluirse en esta versión?", "options": ["User Authentication", "Dashboard Updates", "API Improvements", "Mobile Support"] } }

Todas las solicitudes aparecerán en la interfaz web, donde podrá proporcionar respuestas. En el caso de las preguntas de opción múltiple, puede seleccionar varias opciones y añadir comentarios a cada una de ellas.

Arquitectura

• askme-server: servidor MCP stdio con puente HTTP integrado para la comunicación con el navegador
• askme-ui: Angular 20+ frontend con UI reactiva usando señales
• askme-compartido: Tipos TypeScript compartidos para la comunicación frontend-backend

Desarrollo

# Ejecutar la interfaz de usuario en modo de desarrollo npx nx serve askme-ui Ejecutar el servidor en modo de desarrollo npx nx serve askme-server Ejecutar pruebas npx nx test askme-ui npx nx test askme-server Lint code npx nx lint askme-ui npx nx lint askme-server

Solución de problemas

Problemas de conexión con código Claude

Si ve errores de "Conexión fallida

1. Active el modo de depuración: Ejecute con registro de depuración para ver lo que está sucediendo:

   ASK_ME_MCP_DEBUG=1 claude --debug

2. Compruebe el servidor: Comprueba si el servidor funciona correctamente:

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

3. Conflictos de puertos: Si el puerto 3000 está en uso, especifique un puerto diferente:

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

4. Prueba manual: Ejecute el servidor directamente para ver si hay errores:

   npx --yes ask-me-mcp

Problemas comunes

• Confirmación por primera vez: La primera ejecución de npx ask-me-mcp puede pedir confirmación. Utilice npx --yes para saltársela.
• Puerto ya en uso: El servidor encuentra automáticamente un puerto disponible, pero puede especificar uno con --port
• Elnavegador no se abre: Si el navegador no se abre automáticamente, navegue manualmente hasta el puerto mostrado en los registros de depuración

Licencia

MIT