my-mcp-server

Ein Projekt zum Ausprobieren und Experimentieren für die Erstellung eines MCP (Model Context Protocol)-Servers mit TypeScript. Es demonstriert, wie Tools und Ressourcen KI-Agenten und Sprachmodellen über den stdio-Transport bereitgestellt werden.

Der Server verwaltet eine einfache Benutzerdatenbank, die auf einer lokalen JSON-Datei basiert, und stellt Endpunkte bereit, die ein KI-Agent aufrufen kann, um Benutzerdatensätze zu lesen oder zu erstellen.

Funktionen

• Tool — my-create-tool: Erstellt einen neuen Benutzer, indem die Felder name, address, email und phone entgegengenommen und der Datensatz in src/users.json gespeichert wird.

• Ressource — users://all: Gibt die vollständige Liste der Benutzer aus der Mock-Datenbank als JSON zurück.

• Ressource — users://{userId}/profile: Gibt das Profil eines einzelnen Benutzers zurück, der über userId identifiziert wird.

Related MCP server: FastMCP Example Server

Voraussetzungen

• Node.js v18 oder höher

• npm v9 oder höher

Installation

npm install

Den Server ausführen

Entwicklungsmodus (mit tsx, ohne Build-Schritt)

npm run server:dev

Kompilierte Ausgabe erstellen und ausführen

npm run server:build   # compiles TypeScript → JavaScript
node dist/server.js    # run the compiled server

Watch-Modus (bei Änderungen automatisch neu kompilieren)

npm run server:build:watch

Untersuchen mit der MCP Inspector UI

Der MCP Inspector ermöglicht es, Tools interaktiv aufzurufen und Ressourcen in einer Browser-Oberfläche zu durchsuchen:

npm run server:inspect

Hinweis: server:inspect setzt DANGEROUSLY_OMIT_AUTH=true — dies nur für die lokale Entwicklung verwenden.

Laden des MCP-Servers in Agent-Umgebungen

Agent-CLI (z. B. Claude Code CLI)

Das Vorhandensein von .mcp.json sollte vom Agenten erkannt werden, woraufhin er zum Laden des Servers auffordert. Andernfalls handelt es sich um eine einfache MCP-Server-Konfiguration, die zusammen mit anderen Servern zur Konfiguration hinzugefügt werden muss.

Projektstruktur

my-mcp-server/
├── src/
│   ├── server.ts      # MCP server entry point (tools & resources)
│   └── users.json     # Mock user database (read/written at runtime)
├── package.json
└── tsconfig.json

Tech-Stack

Lizenz

ISC