MCP-Server-Integration — Build-Übung

Grundgerüst für die CCA-F-Vorbereitungsübung aus 2.4 MCP Server Integration. Hier ist nichts gelöst — jede Aufgabe unten hat ein TODO, das du ausfüllen musst.

Aufgaben-Checkliste

• 1. Projektkonfiguration — .mcp.json hat einen github Server-Eintrag (command/args). Tausche ihn gegen einen beliebigen Community- Server aus, falls du nicht GitHub verwendest.

• 2. Umgebungsvariablen-Erweiterung — der github-Eintrag verweist auf ${GITHUB_TOKEN} anstelle einer hartcodierten Anmeldedaten. Kopiere .env.example nach .env und fülle ein echtes Token ein.

• 3. Benutzerkonfiguration — hier absichtlich nicht erstellt, da ~/.claude.json außerhalb des Projekts liegt und für deine Maschine persönlich ist. Vorlage und Schritte: docs/user-level-config.md.

• 4. Eine MCP-Ressource bereitstellen — src/server.ts hat eine Stub-Ressource catalogue://TODO. Ersetze sie durch einen echten Inhaltskatalog (z. B. ein DB-Schema oder eine Dokumentationshierarchie) mit einer korrekten URI, Name, Beschreibung und mimeType.

• 5. Tool-Beschreibungen verbessern — in derselben Datei hat example_tool eine Platzhalterbeschreibung. Schreibe 3–5 Sätze, die Fähigkeit, Ausgabe, Anwendungsfall und den Vergleich mit einer integrierten Alternative abdecken.

Related MCP server: MCP Inspector Server

Einrichtung

npm install
npm run dev        # starts the stdio server directly
npm run inspect     # opens MCP Inspector against the server for manual testing

Layout

.mcp.json                   Task 1 & 2 — project-level server config
.env.example                Task 2 — template for the secret .mcp.json expands
docs/user-level-config.md   Task 3 — template + steps for ~/.claude.json
src/server.ts                Task 4 & 5 — custom MCP server with resource/tool stubs