Servidor MCP nREPL

Un servidor de Protocolo de Contexto de Modelo (MCP) diseñado para clientes MCP, como Claude Desktop o CLine en VSCode. Este servidor se puede usar con cualquier LLM cuando se usa con CLine. Este servidor permite la interacción con una instancia nREPL de Clojure en ejecución, lo que permite la evaluación del código de Clojure, la inspección de espacios de nombres y otras utilidades mediante MCP.

Características

• Conéctese a un servidor nREPL en ejecución especificando el host y el puerto.
• Evalúa el código de Clojure en un espacio de nombres determinado o en el actual.
• Enumere los espacios de nombres del proyecto utilizando tools.namespace .
• Recupere el estado de la conexión nREPL , incluidos los detalles del host, el puerto y la sesión.
• Inspeccione las variables públicas en cualquier espacio de nombres de Clojure, mostrando metadatos como cadenas de documentación y valores.

Instalación y configuración

Instalación en CLine (VSCode) o Claude Desktop

Para utilizar este servidor con CLine o Claude Desktop , siga estos pasos:

1. Abra CLine en VSCode o Claude Desktop .
2. Vaya a Configuración de MCP .
3. Agregue un nuevo servidor MCP con la siguiente configuración:
   { "mcpServers": { "nrepl-mcp-server": { "command": "npx", "args": [ "nrepl-mcp-server" ], "disabled": false, "autoApprove": [] } } }
4. Guarde y reinicie el cliente para aplicar los cambios.

Esto permitirá que el cliente se comunique con el servidor MCP nREPL a través de entrada/salida estándar.

Instalar mediante npx

Para ejecutar rápidamente el servidor sin clonar el repositorio:

Instalación manual

1. Clonar el repositorio
2. Instalar dependencias
   npm install
3. Construir el proyecto (transpila TypeScript a JavaScript)
   npm run build
4. Ejecutar el servidor
   • Modo de producción : se ejecuta desde la salida compilada.
     npm start
   • Modo de desarrollo : utiliza ts-node para cambios en vivo.
     npm run dev

Esto inicia el servidor, que escucha en STDIO las solicitudes MCP. El cliente MCP iniciará el servidor automáticamente.

Comportamiento

Conexión a nREPL

Permite establecer una conexión a un servidor nREPL especificando un host y un puerto .

Evaluación del código Clojure

Ejecuta expresiones Clojure arbitrarias en el espacio de nombres predeterminado o en un espacio de nombres especificado .

Recuperación de información del espacio de nombres

Enumera todos los espacios de nombres en el directorio del proyecto actual usando tools.namespace .

Inspección de variables públicas

Obtiene metadatos y valores actuales para todas las variables públicas en un espacio de nombres especificado.

Obteniendo el estado de la conexión nREPL

Proporciona detalles sobre la conexión nREPL actual, incluido el host, el puerto, la ID de sesión y el último error (si lo hubo).

Recursos

nrepl://status

Proporciona información sobre la conexión nREPL actual, incluyendo:

• Host y puerto
• Estado de la conexión
• ID de sesión activa

nrepl://namespaces

Enumera todos los espacios de nombres detectados en el directorio del proyecto.

Contribuyendo

¡Agradecemos sus contribuciones! Si tiene sugerencias sobre funciones o reportes de errores, abra un problema o una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la Licencia MIT . Puede modificarlo y distribuirlo libremente según sus términos.