OpenRouter MCP Client for Cursor

Un cliente MCP para Cursor que utiliza OpenRouter.ai para acceder a múltiples modelos de IA. Requiere una clave API de OpenRouter.

GitHub

Documentación

OpenRouter MCP Client for Cursor

Un cliente del Protocolo de Contexto de Modelos (MCP) para Cursor que utiliza OpenRouter.ai para acceder a múltiples modelos de IA.

Requisitos

Node.js v18.0.0 o superior (¡importante!)
Clave de API de OpenRouter (obtén una en openrouter.ai/keys)

Características

Conéctate a OpenRouter.ai a través de MCP
Accede a múltiples modelos de IA de diversos proveedores (Google, DeepSeek, Meta, etc.)
Usa el mecanismo de transporte MCP para comunicarte con Cursor
Guarda en caché la información de los modelos para reducir las llamadas a la API
Compatibilidad con modelos gratuitos y de pago
Utilidad de finalización multimodelo para combinar resultados de varios modelos

Modelos disponibles

Este cliente proporciona acceso a todos los modelos disponibles en OpenRouter, incluidos:

Google Gemini 2.5 Pro
DeepSeek Chat v3
Meta Llama 3.1
DeepSeek R1
Qwen Coder
Mistral Small 3.1
¡Y muchos más!

Instalación rápida

La forma más sencilla de instalar es usar el script de configuración:

# Clone the repository
git clone https://your-repo-url/openrouter-mcp-client.git
cd openrouter-mcp-client

# Run the installation script
node install.cjs

El script hará lo siguiente:

Te ayudará a crear un archivo .env con tu clave de API de OpenRouter
Instalará todas las dependencias
Compilará el proyecto
Te dará los siguientes pasos

Instalación manual

Si prefieres instalar manualmente:

# Clone the repository
git clone https://your-repo-url/openrouter-mcp-client.git
cd openrouter-mcp-client

# Install dependencies
npm install

# Copy environment file and edit it with your API key
cp .env.example .env
# Edit .env file with your OpenRouter API key

# Build the project
npm run build

Configuración

Edita el archivo .env con tu clave de API de OpenRouter y el modelo predeterminado:

OPENROUTER_API_KEY=your_api_key_here
OPENROUTER_DEFAULT_MODEL=google/gemini-2.5-pro-exp-03-25:free

Obtén tu clave de API en OpenRouter Keys.

Integración con Cursor

Para usar este cliente con Cursor, debes actualizar el archivo de configuración MCP de Cursor:

Encuentra el directorio de configuración de Cursor:
- Windows: %USERPROFILE%\.cursor\
- macOS: ~/.cursor/
- Linux: ~/.cursor/
Edita o crea el archivo mcp.json en ese directorio. Añade una configuración como esta:

{
  "mcpServers": {
    "custom-openrouter-client": {
      "command": "node",
      "args": [
        "FULL_PATH_TO/openrouter-mcp-client/dist/index.js"
      ],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here",
        "OPENROUTER_DEFAULT_MODEL": "google/gemini-2.5-pro-exp-03-25:free"
      }
    }
  }
}

Reemplaza FULL_PATH_TO con la ruta real a tu instalación del cliente.

Reinicia Cursor
Selecciona el cliente de la siguiente manera:
- Abre Cursor
- Pulsa Ctrl+Shift+L (Windows/Linux) o Cmd+Shift+L (macOS) para abrir el selector de modelos
- Elige "custom-openrouter-client" de la lista

Pruebas directas (sin MCP)

Descomenta las funciones de prueba en src/index.ts para probar la interacción directa con la API:

// Uncomment to test the direct API
testDirectApi().catch(console.error);
testMultiModelCompletion().catch(console.error);

Luego ejecuta:

npm start

Desarrollo

# Watch mode for development
npm run dev

Solución de problemas

Requisitos de versión de Node.js

Importante: Este proyecto requiere Node.js v18.0.0 o superior. Si usas una versión anterior, verás advertencias de EBADENGINE y es posible que encuentres errores. Para comprobar tu versión de Node.js:

node --version

Si tienes una versión anterior, descarga e instala la última versión LTS desde nodejs.org.

Errores del sistema de módulos

Si encuentras errores relacionados con ES modules vs CommonJS:

El código principal usa ES modules (indicado por "type": "module" en package.json)
El script de instalación usa CommonJS (con extensión .cjs)
Asegúrate de ejecutar el script de instalación con node install.cjs

Cursor no se conecta

Si Cursor no parece conectarse a tu cliente:

Asegúrate de que la ruta en mcp.json sea correcta y use barras diagonales
Verifica que hayas compilado el cliente con npm run build
Confirma que tu clave de API de OpenRouter sea correcta en los ajustes de entorno
Revisa los registros de Cursor para ver si hay errores

Recursos relacionados

Despliegue en Smithery

Puedes desplegar este cliente MCP en Smithery para ponerlo a disposición de varios agentes y aplicaciones de IA.

Requisitos previos

Cuenta de GitHub
Clave de API de OpenRouter

Pasos para desplegar

Haz un fork de este repositorio en tu cuenta de GitHub
Inicia sesión en Smithery en smithery.ai con tu cuenta de GitHub
Añade un nuevo servidor:
- Haz clic en "Add Server" en el panel de Smithery
- Selecciona tu repositorio con fork
- Configura los ajustes de compilación:
  - Establece el directorio base en la raíz del repositorio
  - Asegúrate de que se detecten el Dockerfile y smithery.yaml
Despliega tu servidor:
- Smithery compilará y desplegará tu servidor MCP automáticamente
- Una vez desplegado, los usuarios pueden configurarlo con su propia clave de API de OpenRouter

Uso de tu servidor desplegado

Después del despliegue, los usuarios pueden acceder a tu servidor a través del registro de Smithery:

En su cliente MCP (como Claude o cualquier otro cliente compatible con MCP), añade el servidor usando el registro de Smithery
Configura su clave de API de OpenRouter y el modelo predeterminado preferido
Comienza a usar el servidor para acceder a múltiples modelos de IA a través de OpenRouter

Smithery vs. Instalación local

Smithery: Más fácil de distribuir a otras personas; no es necesario que los usuarios clonen y compilen el repositorio
Instalación local: Mejor para uso personal y desarrollo; tiene más control sobre el entorno

Elige el enfoque que mejor se adapte a tus necesidades.