MCP TypeScript SDK

Descripción general

El Protocolo de Contexto de Modelo (MCP) permite a las aplicaciones proporcionar contexto para los LLM de manera estandarizada, separando las preocupaciones de proporcionar contexto de la interacción real con el LLM.

Este repositorio contiene la implementación del SDK de TypeScript de la especificación MCP. Funciona en Node.js, Bun y Deno, e incluye:

• Bibliotecas de servidor MCP (herramientas/recursos/prompts, HTTP transmisible, stdio, ayudantes de autenticación)

• Bibliotecas de cliente MCP (transportes, ayudantes de alto nivel, ayudantes OAuth)

• Paquetes de middleware opcionales para entornos de ejecución/marcos específicos (Express, Fastify, Hono, Node.js HTTP)

• Ejemplos ejecutables (en examples/)

Paquetes

Este monorepo publica paquetes divididos:

• @modelcontextprotocol/server: construir servidores MCP

• @modelcontextprotocol/client: construir clientes MCP

Los esquemas de herramientas y prompts utilizan Standard Schema — trae Zod v4, Valibot, ArkType o cualquier biblioteca compatible.

Son adaptadores intencionalmente delgados: no deben introducir nueva funcionalidad MCP ni lógica de negocio. Consulta packages/middleware/README.md para más detalles.

• @modelcontextprotocol/node: envoltorio de transporte HTTP transmisible de Node.js para IncomingMessage / ServerResponse

• @modelcontextprotocol/express: ayudantes de Express (valores predeterminados de la aplicación + validación del encabezado Host)

• @modelcontextprotocol/fastify: ayudantes de Fastify (valores predeterminados de la aplicación + validación del encabezado Host)

• @modelcontextprotocol/hono: ayudantes de Hono (valores predeterminados de la aplicación + hook de análisis del cuerpo JSON + validación del encabezado Host)

Instalación

Servidor

npm install @modelcontextprotocol/server
# or
bun add @modelcontextprotocol/server
# or
deno add npm:@modelcontextprotocol/server

Cliente

npm install @modelcontextprotocol/client
# or
bun add @modelcontextprotocol/client
# or
deno add npm:@modelcontextprotocol/client

Paquetes de middleware opcionales

El SDK también publica paquetes de “middleware” opcionales que te ayudan a integrar MCP en un entorno de ejecución o marco web específico (por ejemplo, Express, Fastify, Hono o Node.js http).

Estos paquetes son adaptadores intencionalmente delgados y no deben introducir características adicionales de MCP ni lógica de negocio. Consulta packages/middleware/README.md para más detalles.

# Node.js HTTP (IncomingMessage/ServerResponse) Streamable HTTP transport:
npm install @modelcontextprotocol/node

# Express integration:
npm install @modelcontextprotocol/express express

# Fastify integration:
npm install @modelcontextprotocol/fastify fastify

# Hono integration:
npm install @modelcontextprotocol/hono hono

Primeros pasos

Así es como se ve un servidor MCP. Este ejemplo mínimo expone una única herramienta greet a través de stdio:

import { McpServer } from '@modelcontextprotocol/server';
import { StdioServerTransport } from '@modelcontextprotocol/server/stdio';
import * as z from 'zod/v4';

const server = new McpServer({ name: 'greeting-server', version: '1.0.0' });

server.registerTool(
    'greet',
    {
        description: 'Greet someone by name',
        inputSchema: z.object({ name: z.string() })
    },
    async ({ name }) => ({
        content: [{ type: 'text', text: `Hello, ${name}!` }]
    })
);

async function main() {
    const transport = new StdioServerTransport();
    await server.connect(transport);
}

main();

¿Listo para construir algo real? Sigue los tutoriales paso a paso:

• Construye tu primer servidor — un servidor de alertas meteorológicas por stdio, desde npm init hasta una llamada a herramienta

• Construye tu primer cliente — conéctate a ese servidor, lista sus herramientas y llámalas

Para ejemplos ejecutables de principio a fin más allá de los tutoriales, consulta:

• examples/README.md — pares de ejemplos cliente/servidor ejecutables y autoverificables (una historia por directorio)

Documentación

• Construye un servidor — tu primer servidor MCP, paso a paso

• Construye un cliente — tu primer cliente MCP, paso a paso

• Sitio de documentación — las guías completas: herramientas, recursos, prompts, servicio sobre HTTP y stdio, clientes, OAuth y migración

• Solución de problemas — errores comunes y sus soluciones

• Referencia de la API

• Documentación de MCP

• Especificación de MCP

Compilación de la documentación localmente

Para trabajar en el sitio de documentación localmente:

pnpm docs:api      # Generate the API reference markdown (output: docs/api/)
pnpm docs:dev      # Start the VitePress dev server for the V2 site
pnpm docs:build    # Build the V2 site (output: docs/.vitepress/dist/)
pnpm docs:multi    # Build the combined V1 + V2 site (output: tmp/docs-combined/)