Interact MCP

Interact MCP

Un servidor MCP (Protocolo de Contexto de Modelo) interactivo que permite la comunicación en tiempo real entre asistentes de IA y usuarios a través de una interfaz de chat basada en web.

Descripción general

Este proyecto proporciona un servidor MCP con una herramienta interact que permite a los asistentes de IA:

• Hacer preguntas y recibir respuestas de los usuarios
• Solicitar confirmación para acciones
• Buscar orientación o aclaraciones
• Compartir información en tiempo real

El servidor cuenta con una interfaz web basada en Gradio que proporciona una interfaz de chat para una interacción fluida con el usuario.

Características

• Interacción en tiempo real: Comunicación bidireccional entre IA y usuarios
• Interfaz de chat basada en web: Interfaz limpia y moderna impulsada por Gradio
• Múltiples opciones de transporte: Compatible con transporte stdio y SSE (Eventos enviados por el servidor)
• Manejo de tiempo de espera: Protección automática de tiempo de espera para respuestas de usuarios
• Historial de chat: Mantiene el historial de conversación durante las sesiones

Instalación

1. Clona este repositorio:

git clone <repository-url>
cd interact-mcp

2. Crea y activa un entorno virtual:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Instala las dependencias:

pip install fastmcp gradio

Uso

Ejecutar el servidor

Opción 1: Transporte SSE (predeterminado)

python server.py

Esto iniciará el servidor en 127.0.0.1:3033 y abrirá automáticamente la interfaz de chat en tu navegador.

Opción 2: Puerto personalizado

python server.py sse 8080

Especifica un puerto personalizado para el transporte SSE.

Opción 3: Transporte Stdio

python server.py --stdio

Usa el transporte stdio para la comunicación directa con MCP.

Usar la interfaz de chat

1. La interfaz web se abrirá automáticamente en tu navegador
2. Espera a que aparezcan los mensajes del asistente de IA
3. Responde a las preguntas o indicaciones en el campo de entrada de texto
4. Tus respuestas se enviarán de vuelta al asistente de IA a través del protocolo MCP

Agregar a Cursor IDE

Para usar este servidor MCP con Cursor IDE, deberás configurarlo en el archivo de configuración de MCP.

1. Abre Cursor IDE y ve a Configuración de Cursor > Herramientas e integraciones y haz clic en "Nuevo servidor MCP"
2. Esto abrirá el archivo ~/.cursor/mcp.json para edición
3. Agrega la siguiente configuración:

{
    "mcpServers": {
        "interact": {
            "command": "path/to/interact-mcp/venv/bin/python3",
            "args": ["path/to/interact-mcp/server.py", "--stdio"]
        }
    }
}

4. Reemplaza path/to/interact-mcp con la ruta real a tu directorio del proyecto
5. La interfaz de Gradio debería abrirse automáticamente en tu navegador

Herramienta MCP

interact(message: str) -> str

La herramienta principal proporcionada por este servidor permite a los asistentes de IA interactuar con los usuarios.

Parámetros:

• message (str): El mensaje para enviar al usuario

Devuelve:

• str: La respuesta del usuario al mensaje

Tiempo de espera:

• El tiempo de espera predeterminado es de 5 minutos (300 segundos)
• Devuelve un mensaje de tiempo de espera si no se recibe respuesta

Crear un ejecutable

Se incluye un archivo de especificación de PyInstaller para crear ejecutables independientes:

pyinstaller server.spec

Esto creará un ejecutable dist/server que incluye todas las dependencias necesarias.

Detalles técnicos

• Construido con el framework FastMCP
• Usa Gradio para la interfaz web
• Implementa subprocesos para la operación concurrente de la interfaz web y el servidor MCP
• Compatible con actualizaciones en tiempo real con mecanismo de actualización periódica

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar problemas o solicitudes de extracción.