GuíasMCP

Tutorial: crear un servidor MCP en TypeScript

Por el equipo de Banzai LabsActualizado el 2 min de lectura

server.tsMCPbuscar_clientecrear_presupuestoleer_stockClaudeTus herramientas, descritas una vez, utilizables por la IA
Un servidor MCP en TypeScript describe tus herramientas; Claude las llama cuando las necesita.

1. Instalar

mkdir mcp-stock && cd mcp-stock
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node

En package.json, añade "type": "module".

2. El servidor

// src/index.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

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

server.registerTool(
  'leer_stock',
  {
    description: 'Devuelve el stock disponible de un producto a partir de su referencia.',
    inputSchema: { referencia: z.string().describe('Referencia del producto, p. ej. TSH-042') },
  },
  async ({ referencia }) => {
    const cant = await leerStock(referencia); // tu base de datos o tu API
    return { content: [{ type: 'text', text: `${referencia}: ${cant} en stock` }] };
  },
);

await server.connect(new StdioServerTransport());

3. Buenas prácticas

  • Una descripción precisaEs lo que lee la IA para elegir la herramienta.
  • Parámetros tipadosEl esquema Zod rechaza las entradas no válidas.
  • Los registros en stderrEn stdio, la salida estándar está reservada al protocolo.
  • Permisos limitadosSolo lectura mientras baste.

4. Compilar y conectar

npx tsc genera build/index.js. Para verlo en Claude: conectar un servidor MCP a Claude Desktop. El principio: el servidor MCP.

Preguntas frecuentes

¿Qué diferencia hay con una API clásica?
El servidor MCP describe sus herramientas en un formato estándar que los clientes de IA saben leer. El mismo servidor sirve para Claude Desktop, Claude Code o un agente propio.
¿Dónde se ejecuta el servidor?
En local, lanzado por el cliente (transporte stdio), o en un servidor remoto accesible por HTTP. Se empieza en local.
¿Cómo proteger las herramientas?
Una herramienta solo accede a lo que necesita, con una cuenta de permisos limitados. Las acciones que modifican (pago, borrado) piden confirmación.

Para leer después

Todas las guías