---
title: "Esqueleto TypeScript, un servidor MCP en 40 líneas — StudioMeyer Academy"
description: "Código mínimo. No es la mejor arquitectura, pero es el punto de entrada más claro."
canonical: "https://studiomeyer.academy/es/lernwege/fuer-entwickler/lektionen/02-typescript-skeleton"
language: es
image: "https://studiomeyer.academy/og/academy-og-share.png"
publisher: "StudioMeyer Academy, https://studiomeyer.academy (llms.txt: https://studiomeyer.academy/llms.txt)"
---

## Qué instalas

```bash
mkdir mi-mcp-server && cd mi-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript tsx @types/node
```

- `@modelcontextprotocol/sdk` es la librería oficial de Anthropic.
- `zod` es para validación de inputs (obligatorio, no opcional).
- `tsx` te deja ejecutar TypeScript directamente sin build step.

## El server mínimo

Archivo `src/index.ts`:

```typescript
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
import { z } from "zod";

const server = new Server(
  { name: "mi-mcp-server", version: "0.1.0" },
  { capabilities: { tools: {} } }
);

const EchoSchema = z.object({
  message: z.string(),
});

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "echo",
      description: "Devuelve el mensaje pasado.",
      inputSchema: {
        type: "object",
        properties: { message: { type: "string" } },
        required: ["message"],
      },
    },
  ],
}));

server.setRequestHandler(CallToolRequestSchema, async (req) => {
  if (req.params.name === "echo") {
    const { message } = EchoSchema.parse(req.params.arguments);
    return { content: [{ type: "text", text: `Echo: ${message}` }] };
  }
  throw new Error(`Unknown tool: ${req.params.name}`);
});

const transport = new StdioServerTransport();
await server.connect(transport);
```

Eso es. 30 líneas de código, un MCP server totalmente funcional.

## Qué hace el código

1. Importa el SDK.
2. Crea un server con nombre + versión.
3. Le dice al cliente: "Tengo una tool llamada `echo`."
4. Cuando el cliente llama `echo`, valida el input con Zod y devuelve un eco.
5. Se conecta vía stdin/stdout con el cliente.

Es la base. Todo MCP server sigue este patrón, por complejo que se vuelva.

## Probarlo

En `package.json` añade este script:

```json
"scripts": { "dev": "tsx src/index.ts" }
```

Luego configura Claude Code:

```bash
claude mcp add mi-server -s user -- npx -y tsx /ruta/al/proyecto/src/index.ts
```

Reinicia Claude Code, teclea `/mcp`, deberías ver "mi-server". Teclea:

> Usa la tool echo de mi-server con el mensaje "Hola"

Claude llama `echo`, devuelve "Echo: Hola".

## Las dos trampas para principiantes

**1\. console.log como debug.** No funciona en servers stdio. console.log va a stdout, el cliente lo lee como mensaje de protocolo, el server crashea. En su lugar: usa `console.error(...)`, va a stderr y no molesta.

**2\. Falta de input validation.** Si el cliente envía algo mal y no validas, el server crashea. El agente lo ve como "Tool failed", hace cosas raras. Siempre Zod schemas. Siempre.

## Qué falta ahora

Esto es el esqueleto. Para un server real necesitas:

- Más tools (en lugar de `echo`, algo útil)
- Llamadas externas a APIs (con error handling, retry, rate limit)
- Auth si hace falta (API keys, OAuth)
- Tests
- Logging
- Deployment (npm publish o Docker)

Eso viene en las siguientes lecciones. El esqueleto es el cuerpo, no el sprint.

## Siguiente lección

Tool design. Cómo escribir tools buenas que el modelo use bien. Es la diferencia entre "mi server existe" y "mi server se usa".

Puedes leer todo libremente. Con una cuenta se guarda tu progreso.

[Iniciar sesión](https://studiomeyer.academy/es/login?next=%2Fes%2Flernwege%2Ffuer-entwickler%2Flektionen%2F02-typescript-skeleton)

Para desarrolladores · Módulo 1 de 1

## Para desarrolladores

[Volver a la ruta](https://studiomeyer.academy/es/lernwege/fuer-entwickler)

## Tus notas

Inicia sesión para guardar tus propias notas sobre esta lección.

[Iniciar sesión](https://studiomeyer.academy/es/login?next=%2Fes%2Flernwege%2Ffuer-entwickler%2Flektionen%2F02-typescript-skeleton)

## Sitemap

Páginas públicas de este sitio como Markdown: [sitemap](https://studiomeyer.academy/sitemap.md). Punto de entrada curado: [llms.txt](https://studiomeyer.academy/llms.txt), texto completo: [llms-full.txt](https://studiomeyer.academy/llms-full.txt).