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:

brew install llm

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

llm --version

Related MCP server: MCP Server Starter

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:

import { TestClient } from "./utils/TestClient";

describe("YourTool", () => {
  const client = new TestClient();

  it("should process data correctly", async () => {
    await client.assertToolCall(
      "your-tool-name",
      { input: "test" },
      (result) => {
        expect(result.toolResult.content).toBeDefined();
      }
    );
  });
});

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:

npm run build
npm run link

Cuando hayas terminado de probar, puedes desvincular el paquete:

npm run unlink

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