ASKME-CLI

[!NOTE] ¡Nos encantaría tu ayuda! Si pruebas askme-cli en Windows o tienes correcciones de compatibilidad, los PRs son muy bienvenidos👏.

Un servidor MCP (Model Context Protocol) que proporciona una interfaz de confirmación de usuario para asistentes de IA

简体中文 | 日本語

Por qué

Los asistentes de IA a menudo necesitan confirmación del usuario o próximos pasos, pero no hay una forma sencilla de obtener la entrada del usuario durante las conversaciones MCP.

Este proyecto proporciona un endpoint de confirmación personal a través de una interfaz de terminal.

Cómo empezar

Necesitarás configurar tu cliente MCP para usar ASKME-CLI.

Implementa la configuración siguiendo las instrucciones a continuación.

Configuración rápida con npx

# View help and configuration examples
npx askme-cli help

# Run directly (when called by MCP client)
npx askme-cli

Configurar el cliente MCP

Añade a tu archivo de configuración del cliente MCP:

Cursor (.cursor/mcp_servers.json)

{
  "mcpServers": {
    "askme-cli": {
      "command": "npx",
      "args": ["askme-cli"],
      "env": {
        "ASKME_CLI_TERMINAL": "warp"
      }
    }
  }
}

Otros clientes MCP

{
  "mcpServers": {
    "askme-cli": {
      "command": "npx",
      "args": ["askme-cli"],
      "env": {
        "ASKME_CLI_TERMINAL": "iterm2"
      }
    }
  }
}

Desarrollo local

# Clone and install
git clone <your-repo-url>
cd askme-cli
npm install

# Build and run
npm run build
npm run start

Cómo usar

Una vez configurado, el asistente de IA puede usar la herramienta ask_me para recopilar la confirmación del usuario:

1. El asistente de IA llama a la herramienta ask_me con un resumen del trabajo completado
2. ASKME-CLI abre una nueva ventana de terminal con la interfaz de confirmación
3. El usuario introduce el siguiente plan o confirmación y lo envía
4. El asistente de IA recibe la entrada del usuario para continuar

Soporte de terminales

Configura mediante la variable de entorno ASKME_CLI_TERMINAL:

Terminal	Valor	Descripción
Warp	warp	Predeterminado, aplicación de terminal moderna
iTerm2	iterm2	Terminal popular de macOS
Terminal	terminal	Terminal del sistema macOS
Kitty	kitty	Terminal multiplataforma
Alacritty	alacritty	Terminal acelerada por GPU
Hyper	hyper	Terminal basada en web

Referencia de la API

Herramienta ask_me

Recopila el siguiente plan o confirmación del usuario.

Parámetros:

• what_we_did (cadena): Resumen del trabajo completado por la IA

Devuelve:

• La entrada del usuario para el siguiente plan o confirmación
• Admite entrada de texto e imágenes

Ejemplos de uso

Integración con el asistente de IA

Para usar ASKME-CLI de manera efectiva en tu asistente de IA, añade estas reglas a tu prompt del sistema:

- Must call the askme-cli.ask_me tool before ending any user prompt every time.
- All prompts starting with /tk, don't modify code or files, and call the askme-cli.ask_me tool before ending.
- When you have questions, always call the askme-cli.ask_me tool before ending.
- If you have ideas for new features or changes, explain them clearly, analyze their feasibility, and ask if I want to proceed.

Ejemplo de llamada a la herramienta

{
  "tool": "ask_me",
  "parameters": {
    "what_we_did": "I've completed setting up the database schema and created the user authentication endpoints. The API is now ready for testing."
  }
}

Stack tecnológico

• TypeScript - Desarrollo con seguridad de tipos
• React + Ink - Framework de interfaz de terminal
• MCP SDK - Soporte para Model Context Protocol
• Node.js - Entorno de ejecución

Licencia

MIT