Claude-LMStudio Bridge

Puente Claude-LMStudio

Un servidor MCP que conecta a Claude con los LLM locales que se ejecutan en LM Studio.

Descripción general

Esta herramienta le permite a Claude interactuar con sus LLM locales que se ejecutan en LM Studio, proporcionando:

• Acceso al listado de todos los modelos disponibles en LM Studio
• La capacidad de generar texto utilizando sus LLM locales
• Soporte para completar chats a través de tus modelos locales
• Una herramienta de comprobación del estado para verificar la conectividad con LM Studio

Prerrequisitos

• Claude Desktop con soporte para MCP
• LM Studio instalado y ejecutándose localmente con el servidor API habilitado
• Python 3.8+ instalado

Inicio rápido (recomendado)

Para macOS/Linux:

1. Clonar el repositorio

2. Ejecutar el script de configuración

3. Siga las instrucciones del script de instalación para configurar Claude Desktop

Para Windows:

1. Clonar el repositorio

2. Ejecutar el script de configuración

3. Siga las instrucciones del script de instalación para configurar Claude Desktop

Configuración manual

Si prefieres configurar las cosas manualmente:

1. Crear un entorno virtual (opcional pero recomendado)

2. Instalar los paquetes necesarios

3. Configurar Claude Desktop:
   • Abra las preferencias de Claude Desktop
   • Vaya a la sección 'Servidores MCP'
   • Agregue un nuevo servidor MCP con la siguiente configuración:
     • Nombre : lmstudio-bridge
     • Comando : /bin/bash (en macOS/Linux) o cmd.exe (en Windows)
     • Argumentos :
       • macOS/Linux: /ruta/a/claude-lmstudio-bridge/run_server.sh
       • Windows: /c C:\ruta\a\claude-lmstudio-bridge\run_server.bat

Uso con Claude

Después de configurar el puente, puedes usar los siguientes comandos en Claude:

1. Compruebe la conexión a LM Studio:

2. Lista de modelos disponibles:

3. Generar texto con un modelo local:

4. Enviar una finalización de chat:

Solución de problemas

Diagnóstico de problemas de conexión de LM Studio

Utilice la herramienta de depuración incluida para comprobar su conexión a LM Studio:

Para pruebas más detalladas:

Problemas comunes

"No se puede conectar a la API de LM Studio"

• Asegúrese de que LM Studio se esté ejecutando
• Verifique que el servidor API esté habilitado en LM Studio (Configuración > Servidor API)
• Verifique que el puerto (predeterminado: 1234) coincida con el que figura en su archivo .env

"No hay modelos cargados"

• Abra LM Studio y cargue un modelo
• Verifique que el modelo se esté ejecutando correctamente

"No se encontró el paquete MCP"

• Intente reinstalar: pip install "mcp[cli]" httpx python-dotenv
• Asegúrate de estar usando Python 3.8 o posterior

"Claude no puede encontrar el puente"

• Comprobar la configuración de Claude Desktop
• Asegúrese de que la ruta a run_server.sh o run_server.bat sea correcta y absoluta
• Verifique que el script del servidor sea ejecutable: chmod +x run_server.sh (en macOS/Linux)

Configuración avanzada

Puede personalizar el comportamiento del puente creando un archivo .env con estas configuraciones:

Establezca DEBUG=true para habilitar el registro detallado para la resolución de problemas.

Licencia

Instituto Tecnológico de Massachusetts (MIT)