---
title: "TypeScript-Skeleton, ein MCP-Server in 40 Zeilen — StudioMeyer Academy"
description: "Der minimale Code. Nicht die beste Architektur, aber der klarste Einstiegspunkt."
canonical: "https://studiomeyer.academy/lernwege/fuer-entwickler/lektionen/02-typescript-skeleton"
language: de
image: "https://studiomeyer.academy/og/academy-og-share.png"
publisher: "StudioMeyer Academy, https://studiomeyer.academy (llms.txt: https://studiomeyer.academy/llms.txt)"
---

## Was Du installierst

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

- `@modelcontextprotocol/sdk` ist die offizielle Anthropic-Library.
- `zod` ist für Input-Validation (Pflicht, nicht optional).
- `tsx` lässt Dich TypeScript direkt ausführen ohne Build-Step.

## Der minimale Server

Datei `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: "mein-mcp-server", version: "0.1.0" },
  { capabilities: { tools: {} } }
);

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

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [
    {
      name: "echo",
      description: "Gibt die uebergebene Nachricht zurück.",
      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);
```

Das war's. 30 Zeilen Code, ein voll-funktionsfähiger MCP-Server.

## Spielen, im Editor anschauen

Lies den Code im Editor unten durch. Die zwei Request-Handler sind der Kern: `ListToolsRequestSchema` antwortet mit der Tool-Liste, `CallToolRequestSchema` führt einen Tool-Call aus. Klick Dich durch `src/index.ts` und `package.json` und fühl den Aufbau.

Editieren ist erlaubt (lokale Experimente). Ausführen geht hier nicht. MCP-Server brauchen Node + stdio, das läuft nicht im Browser. Wenn Du den Code laufen lassen willst, folge den Schritten weiter unten lokal.

## Was der Code tut

1. Importiert den SDK.
2. Erstellt einen Server mit Name + Version.
3. Meldet dem Client: "Ich habe ein Tool namens `echo`."
4. Wenn der Client `echo` aufruft, validiert den Input mit Zod und gibt ein Echo zurück.
5. Verbindet sich über stdin/stdout mit dem Client.

Das ist die Basis. Jeder MCP-Server folgt diesem Muster, egal wie komplex er wird.

## Testen

In `package.json` diesen Script eintragen:

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

Dann Claude Code konfigurieren:

```bash
claude mcp add mein-server -s user -- npx -y tsx /pfad/zum/projekt/src/index.ts
```

Claude Code neu starten, `/mcp` eingeben, Du solltest "mein-server" sehen. Tippen:

> Benutze mein-server's echo-Tool mit der Nachricht "Hallo"

Claude ruft `echo` auf, gibt "Echo: Hallo" zurück.

## Die zwei Fallen für Anfänger

**1\. console.log als Debug.** Geht NICHT bei stdio-Servern. console.log landet auf stdout, das liest der Client als Protokoll-Nachricht, der Server crashes. Stattdessen: `console.error(...)` nutzen, das geht nach stderr und stört nicht.

**2\. Fehlende Input-Validation.** Wenn der Client was falsches schickt und Du validierst nicht, crashed Dein Server. Der Agent sieht den Crash als "Tool failed", macht komische Sachen. Immer Zod-Schemas. Immer.

## Was jetzt fehlt

Das ist das Skeleton. Für einen echten Server brauchst Du:

- Mehr Tools (statt `echo` was Nützliches)
- Externe API-Calls (mit Error-Handling, Retry, Rate-Limit)
- Auth falls nötig (API-Keys, OAuth)
- Tests
- Logging
- Deployment (npm publish oder Docker)

Das kommt in den nächsten Lektionen. Das Skeleton ist der Bauch, nicht der Sprint.

## Nächste Lektion

Tool-Design. Wie Du gute Tools schreibst die vom Modell richtig benutzt werden. Das ist der Unterschied zwischen "mein Server existiert" und "mein Server wird genutzt".

Du kannst alle Inhalte frei lesen. Mit einem Konto bleibt dein Fortschritt gespeichert.

[Anmelden](https://studiomeyer.academy/login?next=%2Flernwege%2Ffuer-entwickler%2Flektionen%2F02-typescript-skeleton)

Für Entwickler · Modul 1 von 1

## Für Entwickler

[Zum Lernweg](https://studiomeyer.academy/lernwege/fuer-entwickler)

## Deine Notizen

Melde Dich an, um Deine eigenen Notizen zu dieser Lektion zu speichern.

[Anmelden](https://studiomeyer.academy/login?next=%2Flernwege%2Ffuer-entwickler%2Flektionen%2F02-typescript-skeleton)

## Sitemap

Öffentliche Seiten dieser Website als Markdown: [Sitemap](https://studiomeyer.academy/sitemap.md). Kuratierter Einstieg: [llms.txt](https://studiomeyer.academy/llms.txt), Volltext: [llms-full.txt](https://studiomeyer.academy/llms-full.txt).