AskMeMCP

AskMeMCP - Servidor MCP con Intervención Humana

AskMeMCP es un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los asistentes de IA solicitar entrada humana a través de una interfaz web. Implementa múltiples herramientas interactivas (ask-one-question, ask-multiple-choice, challenge-hypothesis, choose-next), permitiendo que clientes MCP como Claude Code pausen la ejecución y esperen respuestas humanas.

Características

• Transporte stdio: Integración directa con Claude Code y otros clientes MCP
• Servidor Autónomo: Sirve la interfaz Angular estáticamente - no se necesita un servidor de UI separado
• Asignación Dinámica de Puertos: Encuentra automáticamente un puerto disponible si el predeterminado está en uso
• Apertura Automática del Navegador: Abre la interfaz automáticamente cuando llegan solicitudes
• Actualizaciones en Tiempo Real: Eventos enviados por el servidor para comunicación en vivo
• Múltiples Tipos de Herramientas: Preguntas individuales, opción múltiple, desafíos de hipótesis y flujos de decisión

Instalación

Opción 1: Usando npx (Sin instalación requerida)

Puedes ejecutar Ask-Me MCP directamente usando npx sin instalarlo globalmente:

npx ask-me-mcp

Nota: La primera vez que ejecutes esto, npx pedirá confirmación para instalar el paquete temporalmente. Para omitir esta confirmación, usa:

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ñade a tu archivo de configuración de 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ñade manualmente a tu configuración de 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ñade a tu configuración de Cursor (en .cursor/mcp_settings.json en la raíz de tu proyecto):

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

VS Code con Continue o Extensiones Similares

Para extensiones de VS Code que soporten MCP, añade a la configuración de tu extensión:

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

Configuración de Puerto

El servidor tiene dos comportamientos de puerto:

1. Auto-descubrimiento (predeterminado): Encuentra un puerto disponible a partir de 3000

   npx --yes ask-me-mcp
   

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

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

Para configuración de Claude Code con puerto fijo:

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

Opción 3: Compilar desde el Código Fuente

# Clone the repository
git clone https://github.com/yourusername/AskMeMCP.git
cd AskMeMCP

# Install dependencies
npm install

# Build all projects
npm run build

# Configure Claude Code with full path

Añade a tu configuración de Claude Code:

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

Uso

Una vez configurado, puedes usar las herramientas disponibles en Claude Code:

Herramienta ask-one-question

Please use the ask-one-question tool to ask me what my favorite color is

Herramienta ask-multiple-choice

Please use the ask-multiple-choice tool with these questions:
{
  "questions": [
    {
      "text": "Which deployment environments should we target?",
      "options": ["Development", "Staging", "Production"]
    },
    {
      "text": "Which features should be included in this release?",
      "options": ["User Authentication", "Dashboard Updates", "API Improvements", "Mobile Support"]
    }
  ]
}

Todas las solicitudes aparecerán en la interfaz web donde puedes proporcionar respuestas. Para preguntas de opción múltiple, puedes seleccionar múltiples opciones y añadir comentarios a cada elección.

Arquitectura

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

Desarrollo

# Run the UI in development mode
npx nx serve askme-ui

# Run the server in development mode
npx nx serve askme-server

# Run tests
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 Claude Code

Si ves errores de "Conexión fallida":

1. Habilitar Modo de Depuración: Ejecuta con registro de depuración para ver qué está sucediendo:

   ASK_ME_MCP_DEBUG=1 claude --debug
   

2. Verificar el Servidor: Prueba si el servidor se ejecuta correctamente:

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

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

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

4. Prueba Manual: Ejecuta el servidor directamente para ver cualquier error:

   npx --yes ask-me-mcp
   

Problemas Comunes

• Confirmación de Primera Vez: La primera ejecución de npx ask-me-mcp puede pedir confirmación. Usa npx --yes para omitir esto.
• Puerto Ya en Uso: El servidor encuentra automáticamente un puerto disponible, pero puedes especificar uno con --port
• El Navegador No se Abre: Si el navegador no se abre automáticamente, navega manualmente al puerto mostrado en los registros de depuración

Licencia

MIT