Servidor MCP de TypeScript

Genera un servidor TypeScript del Model Context Protocol (MCP) para proporcionar contexto a Modelos de Lenguaje Grandes (LLMs).

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a asistentes de IA interactuar con herramientas y recursos externos. Proporciona una forma consistente para que los LLMs puedan:

• Ejecutar herramientas (funciones) que realizan acciones o recuperan información
• Acceder a recursos que proveen contexto o datos

Uso

Generar un servidor MCP

Puedes generar un servidor MCP en TypeScript de dos formas:

VSCode

1. Instale el Nx Console VSCode Plugin si aún no lo ha hecho
2. Abra la consola Nx en VSCode
3. Haga clic en Generate (UI) en la sección "Common Nx Commands"
4. Busque @aws/nx-plugin - ts#mcp-server
5. Complete los parámetros requeridos
6. Haga clic en Generate

CLI

pnpm

pnpm nx g @aws/nx-plugin:ts#mcp-server

yarn

yarn nx g @aws/nx-plugin:ts#mcp-server

npm

npx nx g @aws/nx-plugin:ts#mcp-server

bun

bunx nx g @aws/nx-plugin:ts#mcp-server

También puede realizar una ejecución en seco para ver qué archivos se cambiarían

pnpm

pnpm nx g @aws/nx-plugin:ts#mcp-server --dry-run

yarn

yarn nx g @aws/nx-plugin:ts#mcp-server --dry-run

npm

npx nx g @aws/nx-plugin:ts#mcp-server --dry-run

bun

bunx nx g @aws/nx-plugin:ts#mcp-server --dry-run

Consejo

Primero usa el generador ts#project para crear un proyecto donde agregarás tu servidor MCP.

Opciones

Parámetro	Tipo	Predeterminado	Descripción
project Requerido	string	-	The project to add an MCP server to
name	string	-	The name of your MCP server (default: mcp-server)

Salida del generador

El generador agregará los siguientes archivos a tu proyecto TypeScript existente:

• Directoryyour-project/

  • Directorysrc/

    • Directorymcp-server/ (o nombre personalizado si se especifica)

      • index.ts Punto de entrada para el servidor MCP
      • server.ts Definición principal del servidor
      • Directorytools/

        • add.ts Herramienta de ejemplo
      • Directoryresources/

        • sample-guidance.ts Recurso de ejemplo
  • package.json Actualizado con entrada bin y dependencias MCP
  • project.json Actualizado con el target serve del servidor MCP

Trabajando con tu servidor MCP

Agregar herramientas

Las herramientas son funciones que el asistente de IA puede llamar para realizar acciones. Puedes agregar nuevas herramientas en el archivo server.ts:

server.tool("toolName", "tool description",
  { param1: z.string(), param2: z.number() }, // Esquema de entrada usando Zod
  async ({ param1, param2 }) => {
    // Implementación de la herramienta
    return {
      content: [{ type: "text", text: "Result" }]
    };
  }
);

Agregar recursos

Los recursos proveen contexto al asistente de IA. Puedes agregar recursos estáticos desde archivos o recursos dinámicos:

const exampleContext = 'some context to return';

server.resource('resource-name', 'example://resource', async (uri) => ({
  contents: [{ uri: uri.href, text: exampleContext }],
}));

// Recurso dinámico
server.resource('dynamic-resource', 'dynamic://resource', async (uri) => {
  const data = await fetchSomeData();
  return {
    contents: [{ uri: uri.href, text: data }],
  };
});

Configuración con asistentes de IA

Archivos de configuración

La mayoría de los asistentes de IA que admiten MCP utilizan un enfoque de configuración similar. Deberás crear o actualizar un archivo de configuración con los detalles de tu servidor MCP:

{
  "mcpServers": {
    "your-mcp-server": {
      "command": "npx",
      "args": ["tsx", "/path/to/your-mcp-server/index.ts"]
    }
  }
}

Precaución

Si recibes un error como ENOENT npx al conectarte a tu servidor, es posible que necesites especificar la ruta completa a npx, la cual puedes obtener ejecutando which npx en tu terminal.

Recarga en caliente

Durante el desarrollo de tu servidor MCP, puedes configurar el flag --watch para que el asistente de IA siempre vea las versiones más recientes de las herramientas/recursos:

{
  "mcpServers": {
    "your-mcp-server": {
      "command": "npx",
      "args": ["tsx", "--watch", "/path/to/your-mcp-server/index.ts"]
    }
  }
}

Nota

Si agregas nuevas herramientas o recursos, es posible que necesites reiniciar tu servidor MCP en el asistente de IA.

Configuración específica del asistente

Consulta la siguiente documentación para configurar MCP con asistentes de IA específicos:

• Amazon Q Developer
• Cline
• Cursor
• Claude Code
• Roo Code

Consejo

Algunos asistentes de IA, como Amazon Q Developer, permiten especificar configuraciones de servidor MCP a nivel de espacio de trabajo, lo cual es particularmente útil para definir los servidores MCP relevantes para un proyecto en particular.

Ejecutando tu servidor MCP

La forma más fácil de probar y usar un servidor MCP es configurándolo con un asistente de IA (como se muestra arriba). Sin embargo, puedes ejecutar el servidor usando el target <your-server-name>-serve, lo cual puede ser útil si cambias del transporte STDIO al transporte HTTP transmitible.

pnpm

pnpm nx run your-project:your-server-name-serve

yarn

yarn nx run your-project:your-server-name-serve

npm

npx nx run your-project:your-server-name-serve

bun

bunx nx run your-project:your-server-name-serve

Este comando usa tsx --watch para reiniciar automáticamente el servidor cuando los archivos cambian.