MCP SuperAssistant Chrome Extension

Una extensión de Chrome que integra herramientas MCP con plataformas de IA como ChatGPT y Gemini, permitiendo a los usuarios ejecutar herramientas e insertar resultados directamente en las conversaciones.

GitHub

2.6k

Prueba este MCPPatrocinado

Documentación

MCP SuperAssistant Chrome Extension

Lleva MCP a ChatGPT, Perplexity, Grok, Gemini, Google AI Studio, OpenRouter, Kimi, Github Copilot, Mistral y más...

🌐 Visita el sitio web oficial

Latest Release GitHub Stars Chrome Users Firefox Users

Instalación

Descripción general

MCP SuperAssistant es una extensión de Chrome que integra las herramientas del Protocolo de Contexto de Modelo (MCP) con plataformas de IA como Perplexity, ChatGPT, Google Gemini, Google AI Studio, Grok y más. Permite a los usuarios ejecutar herramientas MCP directamente desde estas plataformas, mejorando las capacidades de los asistentes de IA basados en web.

Plataformas actualmente compatibles

Video de demostración

Kimi.com

ChatGPT

¡Mira el video para ver MCP SuperAssistant en acción!

Lista de reproducción de demostración de MCP SuperAssistant

Tutorial de configuración

¿Nuevo en MCP SuperAssistant? Mira esta guía de configuración completa para comenzar en minutos!

Ver tutorial de configuración

¿Qué es MCP?

El Protocolo de Contexto de Modelo (MCP) es un estándar abierto desarrollado por Anthropic que conecta asistentes de IA con sistemas donde realmente viven los datos, incluidos repositorios de contenido, herramientas de negocio y entornos de desarrollo. Sirve como un protocolo universal que permite a los sistemas de IA interactuar de forma segura y dinámica con fuentes de datos en tiempo real.

Características principales

Soporte para múltiples plataformas de IA: Funciona con ChatGPT, Perplexity, Google Gemini, Grok, Google AI Studio, OpenRouter Chat, DeepSeek, Kagi, T3 Chat, GitHub Copilot, Mistral AI, Kimi, Qwen Chat, Z Chat y más
Detección de herramientas: Detecta automáticamente llamadas a herramientas MCP en las respuestas de IA
Ejecución de herramientas: Ejecuta herramientas MCP con un solo clic
Integración de resultados de herramientas: Inserta sin problemas los resultados de la ejecución de herramientas de vuelta en la conversación de IA
Modo de renderizado: Renderiza llamadas a funciones y resultados de funciones.
Modo de ejecución automática: Ejecuta automáticamente las herramientas detectadas
Modo de envío automático: Envía automáticamente la entrada del chat después de insertar el resultado
Modo de contenido push: Opción para empujar el contenido de la página en lugar de superponerlo
Persistencia de preferencias: Recuerda la posición, el tamaño y la configuración de la barra lateral
Soporte de modo oscuro/claro: Se adapta al tema de la plataforma de IA

flowchart TD
    A[AI Chat Interface] -->|Generate| B[Tool Calls]
    B -->|Detect| C[Extension Detects Tool Calls]
    C -->|Send via SSE| D[MCP Local Proxy Server]
    D -->|Forward| E[Actual MCP Server]
    E -->|Return Results| D
    D -->|Return Results| C
    C -->|Insert| F[Add Results Back to Chat]

Conexión al servidor proxy local

Para conectar la extensión de Chrome a un servidor local para proxy de conexiones:

Ejecutar MCP SuperAssistant Proxy mediante npx:

Crea un archivo config.json con los detalles de tu servidor MCP. Por ejemplo, para usar Desktop Commander:

Ejemplo de config.json:
```
{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}
```
config.json también admite otras configuraciones de servidor MCP, como URLs de servidores MCP remotos. Prueba composio mcp, zappier mcp, o smithery o cualquier otro servidor MCP remoto.

O usa la ubicación de archivo de configuración existente de Cursor u otras herramientas:
```
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
```

Inicia el servidor proxy de MCP SuperAssistant usando uno de los siguientes comandos:

npx -y @srbhptl39/mcp-superassistant-proxy@latest --config ./config.json --outputTransport sse

npx -y @srbhptl39/mcp-superassistant-proxy --config ./config.json --outputTransport streamableHttp

npx -y @srbhptl39/mcp-superassistant-proxy --config ./config.json --outputTransport ws

Ver todas las opciones disponibles:

npx -y @srbhptl39/mcp-superassistant-proxy@latest --help

Esto es útil para:

Hacer proxy de servidores MCP remotos
Agregar soporte CORS a servidores remotos
Proporcionar endpoints de salud para monitoreo

Pasos de conexión:

Inicia el servidor proxy usando uno de los comandos anteriores
Abre la barra lateral de MCP SuperAssistant en una de las plataformas de IA compatibles; esto debería mostrar la interfaz de la barra lateral
Haz clic en el indicador de estado del servidor (generalmente muestra "Desconectado")
Ingresa la URL del servidor local (por defecto: http://localhost:3006/sse) El formato de la URL depende del método --outputTransport utilizado:
- Para SSE: http://localhost:3006/sse
- Para Streamable HTTP: http://localhost:3006/mcp
- Para WebSocket: ws://localhost:3006/message
- Elige el método de transporte adecuado (SSE, Streamable HTTP o WebSocket)
- También puedes agregar cualquier URL de servidor MCP remoto aquí, si admite CORS o se proxya a través de este servidor proxy local. Prueba Composio mcp, Zappier mcp o smithery o cualquier otro servidor MCP remoto.
Haz clic en "Conectar" para establecer la conexión
El indicador de estado debería cambiar a "Conectado" si tiene éxito

Uso

Ejemplo de flujo de trabajo:

Navega a una plataforma de IA compatible, por ejemplo ChatGPT.
La barra lateral de MCP SuperAssistant aparecerá en el lado derecho de la página
Configura tus herramientas MCP para habilitar y deshabilitar las herramientas que deseas usar.
En el área de entrada de mensajes, pasa el cursor sobre el botón 'MCP' para ver las herramientas disponibles y sus descripciones.
MCP SuperAssistant requiere agregar un prompt de instrucciones de trabajo MCP al chat, para dar detalles de sus nuevas capacidades y cómo usar las herramientas. Usa el botón 'Insertar' o adjuntar para agregar el prompt de instrucciones.
Una vez que se agrega el prompt de instrucciones, ahora puedes pedirle que lea archivos o cualquier operación relacionada con herramientas MCP.
Cuando la IA quiera usar alguna herramienta, mostrará una tarjeta de llamada a herramienta personalizada con el nombre y los parámetros de la herramienta.
El usuario puede ejecutar manualmente la llamada a la herramienta haciendo clic en el botón "RUN" en la tarjeta de llamada, o si el modo de ejecución automática está habilitado, se ejecutará automáticamente.
La automatización se puede lograr habilitando los modos de ejecución automática y envío automático, haciendo clic en el botón 'MCP' y configurando los modos automáticos.

Consejos y trucos

Desactiva el modo de búsqueda (chatgpt, perplexity) en las interfaces de chat de IA para una mejor experiencia de prompt de llamada a herramientas y para evitar que MCP SuperAssistant se descarrile.
Activa el modo de razonamiento (chatgpt, perplexity, grok) en las interfaces de chat de IA, lo que ayudará a la IA a comprender mejor el contexto y generar las llamadas a herramientas correctas.
Usa modelos de gama alta más nuevos, ya que son mejores para comprender el contexto y generar las llamadas a herramientas correctas.
Copia el prompt de instrucciones de MCP y pégalo en el prompt del sistema del chat de IA (Google AI Studio).
Menciona las herramientas específicas que deseas usar en tu conversación.
Usa los interruptores automáticos de MCP para controlar la ejecución de herramientas.

Problemas comunes con MCP SuperAssistant

Esta página cubre los problemas más comunes que los usuarios encuentran con MCP SuperAssistant y proporciona soluciones para resolverlos.

1. La extensión no detecta llamadas a herramientas

Asegúrate de que la extensión esté habilitada en tu navegador.
Asegúrate de que las instrucciones del prompt de MCP estén correctamente adjuntas o insertadas en el chat, antes de iniciar cualquier chat.
Verifica que tu plataforma de IA admita llamadas a herramientas y que la función esté habilitada.
Actualiza la página o reinicia tu navegador si el problema persiste.

2. La ejecución de herramientas falla

Asegúrate de que tu servidor proxy esté en ejecución y que la URL sea correcta en la configuración del servidor de la barra lateral.
Revisa tu archivo config.json para detectar errores o problemas de formato.
Verifica tu conectividad de red y la configuración del firewall.

3. Problemas de conexión

Asegúrate de que tu servidor MCP esté en ejecución y sea accesible.
Verifica la URL del servidor en la configuración de la extensión.
Primero inicia el servidor npx mcp-SuperAssistant-proxy y luego recarga/reinicia la extensión desde la página chrome://extensions/.
Revisa los registros del servidor proxy para detectar errores o problemas.
Asegúrate de que tu firewall o software antivirus no esté bloqueando la conexión.
Asegúrate de que el servidor muestre el estado de conexión adecuado y exponga el endpoint /sse.

4. Formato incorrecto de llamada a herramienta

A veces el modelo no genera el formato de llamada a herramienta correcto como se solicita, lo que hace que la detección de herramientas falle. En tales casos, usa mejores modelos que estén diseñados para llamadas a herramientas o que tengan mejores capacidades de llamada a herramientas.
Usa el prompt de instrucciones personalizado, que se puede encontrar en la barra lateral de MCP SuperAssistant.
Pide explícitamente usar las herramientas mencionándolas en el prompt.
A continuación se muestra un ejemplo del formato correcto de llamada a función MCP, que es renderizado por la extensión MCP SuperAssistant:

```jsonl
{"type": "function_call_start", "name": "function_name", "call_id": 1}
{"type": "description", "text": "Short 1 line of what this function does"}
{"type": "parameter", "key": "parameter_1", "value": "value_1"}
{"type": "parameter", "key": "parameter_2", "value": "value_2"}
{"type": "function_call_end", "call_id": 1}


### Manual Installation (Development)

#### Release Version
1. Download the latest release from [Releases](https://github.com/srbhptl39/MCP-SuperAssistant/releases)
2. Unzip the downloaded file
3. Navigate to `chrome://extensions/` in Chrome
4. Enable "Developer mode"
5. Click "Load unpacked" and select the unzipped directory
6. Follow [Connecting to Local Proxy Server](#connecting-to-local-proxy-server) to connect to your MCP server

## Development

### Prerequisites

- Node.js (v16+)
- pnpm

### Setup

```bash
# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

# Create zip package for distribution
pnpm zip

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Haz un fork del repositorio
Crea tu rama de características (git checkout -b feature/amazing-feature)
Haz commit de tus cambios (git commit -m 'Add some amazing feature')
Haz push a la rama (git push origin feature/amazing-feature)
Abre un Pull Request

Autor

Saurabh Patel

Patrocinio y soporte

Este proyecto se desarrolla enteramente en mi tiempo libre, impulsado por la pasión por la IA y el Protocolo de Contexto de Modelo (MCP). Como profesional a tiempo completo, equilibrar los compromisos laborales con el desarrollo de código abierto hace que sea difícil contribuir regularmente y mantener el ritmo de actualizaciones.

Tu apoyo me ayuda a dedicar más tiempo a:

🐛 Corregir errores y abordar problemas
✨ Agregar nuevas funciones y soporte de plataformas
📚 Mejorar la documentación y los tutoriales
🔄 Mantener las dependencias actualizadas
💬 Responder a las solicitudes de la comunidad

Apoya este proyecto:

⭐ Marca el repositorio con una estrella para mostrar tu agradecimiento
💖 Patrocina en GitHub para ayudar a sostener el desarrollo
🐦 Sígueme en Twitter (@srbhptl39) para actualizaciones
📧 Para soporte privado o implementaciones personalizadas, contacta a través de Twitter

¡Cada contribución, grande o pequeña, ayuda a mantener este proyecto vivo y próspero! 🙏

Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para obtener más detalles.

Agradecimientos

Inspirado por el Protocolo de Contexto de Modelo (MCP) de Anthropic
Gracias a Cline por la inspiración de la idea
Construido con Chrome Extension Boilerplate con React + Vite

MCP SuperAssistant Chrome Extension

Documentación

MCP SuperAssistant Chrome Extension

Instalación

Descripción general

Plataformas actualmente compatibles

Video de demostración

Tutorial de configuración

¿Qué es MCP?

Características principales

Conexión al servidor proxy local

Ejecutar MCP SuperAssistant Proxy mediante npx:

Pasos de conexión:

Uso

Consejos y trucos

Problemas comunes con MCP SuperAssistant

1. La extensión no detecta llamadas a herramientas

2. La ejecución de herramientas falla

3. Problemas de conexión

4. Formato incorrecto de llamada a herramienta

Contribuciones

Autor

Saurabh Patel

Patrocinio y soporte

Licencia

Agradecimientos

Historial de estrellas