GuíasMCP
Tutorial: crear un servidor MCP en TypeScript
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.