Plantilla de servidor MCP

Prerrequisitos

Instalación de la CLI de LLM

Este proyecto requiere la instalación de la CLI de LLM. Puedes instalarla con Homebrew:

Después de la instalación, asegúrese de que el comando llm esté disponible en su RUTA ejecutando:

Related MCP server: MCP Framework

Empezando

Desarrollo

1. Instalar dependencias:

   npm install

2. Inicie el servidor de desarrollo con recarga en caliente:

   npm run dev

3. Construir el proyecto:

   npm run build

4. Ejecutar pruebas:

   npm test

5. Inicie el servidor de producción:

   npm start

Herramienta de arquitecto

La herramienta Arquitecto ( src/tools/architect.ts ) proporciona una interfaz para interactuar con la CLI de LLM y obtener retroalimentación sobre el diseño arquitectónico. Mantiene el contexto de la conversación y gestiona la comunicación entre la aplicación y la CLI de LLM.

Características

• Mantiene el contexto de la conversación a lo largo de múltiples interacciones.

• Maneja la ejecución de comandos a través de la CLI de LLM

• Proporciona gestión y registro de errores.

• Admite tanto conversaciones nuevas como discusiones continuas.

Requisitos

• La CLI de LLM debe estar instalada y disponible en su PATH (consulte la sección Requisitos previos)

• Las variables de entorno deben configurarse correctamente para la CLI de LLM

Pruebas

La plantilla incluye un TestClient integrado para pruebas locales y el MCP Inspector para depuración visual.

Uso de TestClient

TestClient proporciona una forma sencilla de probar sus herramientas:

Uso del inspector MCP

La plantilla incluye el Inspector MCP para la depuración visual de sus herramientas:

1. Iniciar el inspector:

   npx @modelcontextprotocol/inspector node dist/index.js

2. Abra la interfaz de usuario del inspector en http://localhost:5173

El inspector proporciona:

• Interfaz visual para herramientas de prueba

• Monitoreo de solicitudes y respuestas en tiempo real

• Inspección de metadatos de la herramienta

• Entorno de pruebas interactivo

Pruebas locales con cursor

Para probar su servidor MCP localmente con Cursor:

1. Construya y vincule el paquete:

   npm run build npm run link

2. Verificar que el binario funciona:

   npx architect-test-mcp-tool

3. Añade el servidor al Cursor:

   • Abrir la configuración del cursor

   • Vaya a la pestaña Características

   • Desplácese hacia abajo hasta la sección Servidores MCP

   • Haga clic en "Agregar servidor"

   • Seleccione el tipo "Comando"

   • Asígnele un nombre (por ejemplo, "Herramienta de ejemplo local")

   • Ingrese el comando: npx architect-test-mcp-tool

   • Haga clic en Confirmar

4. Verifique que el servidor se inicie correctamente en Cursor verificando que la sección Servidores MCP muestre que su servidor está en ejecución.

Nota: Si realiza cambios en su código, recuerde reconstruirlo y volver a vincularlo:

Cuando hayas terminado de probar, puedes desvincular el paquete:

Esto eliminará el enlace simbólico global creado durante el desarrollo.

Solución de problemas

Uso del inspector MCP

El Inspector MCP es una herramienta útil para depurar e inspeccionar su servidor MCP. Para usarlo:

1. Primero, construye tu proyecto:

   npm run build

2. Ejecute el inspector:

   npx @modelcontextprotocol/inspector node dist/index.js

El inspector proporciona una interfaz web que le permite:

• Ver todas las herramientas disponibles y sus esquemas

• La herramienta de prueba llama de forma interactiva

• Inspeccionar las cargas útiles de solicitud/respuesta

• Depurar problemas de comunicación entre el servidor y los clientes