workshop-27-08-26

Beispiel für einen MCP-Server für den Workshop des Bootcamps AWS AI FDE for Commerce vom 27/08/2026

Was ist MCP?

Das MCP (Model Context Protocol) ist ein Open-Source-Kommunikationsprotokoll zwischen Systemen, das den Austausch von Daten-/Kontextinformationen zwischen verschiedenen Anwendungen (hauptsächlich KI) ermöglicht.

Mit diesem Protokoll kann ein KI-System (wie eine Agentenanwendung) kontextuelle Informationen von/an ein anderes System konsumieren/bereitstellen, sodass Modelle mit mehr Sicherheit und Relevanz arbeiten können.

Unter Verwendung der USB-C-Analogie:

Denken Sie an MCP als einen USB-C-Anschluss für KI-Anwendungen. So wie USB-C eine standardisierte Möglichkeit bietet, elektronische Geräte zu verbinden, bietet MCP eine standardisierte Möglichkeit, KI-Anwendungen mit anderen Systemen zu verbinden.

Related MCP server: Basic MCP Server

SDK-Optionen

Das Protokoll unterstützt verschiedene SDK-Optionen (Software Development Kits), die zur Implementierung von MCP in verschiedenen Sprachen/Frameworks verwendet werden können.

Die vollständige Liste finden Sie hier: Verfügbare SDKs

Transportoptionen

Mit Fokus auf den Workshop-Kontext werden wir die gängigsten/populärsten Transportoptionen für Node.js untersuchen:

stdio

Lassen Sie den MCP-Server als untergeordneten Prozess laufen und senden/empfangen Sie Nachrichten über stdin und stdout.

Über stdio bereitstellen

HTTP

Stellen Sie einen Server bereit, der Nachrichten über HTTP-Anfragen empfängt und sendet, für mehrere Clients gleichzeitig.

Über HTTP bereitstellen

Frameworks

Nutzen Sie Node.js-Technologien/-Frameworks, um die Implementierung des MCP-Protokolls zu erleichtern, wie:

• Express

• Fastify

• Hono

Workshop-Szenario

Kunde Nordesul

1. Betrachten Sie ein E-Commerce-Projekt bei einem großen Kunden mit einem Team von 20 Entwicklern, die mit der Migration seines Legacy-Onlineshops (V0) auf ein moderneres Framework (V1) beauftragt sind. Ziel ist es, dass der Onlineshop V1 identisch zu V0 ist, aber die Leistungsverbesserungen von V1 nutzt.

2. Da verschiedene Entwickler an derselben Codebasis arbeiten werden, ist es von größter Bedeutung, dass die Lieferungen die bestmögliche Standardisierung und Qualität aufweisen, gemäß den Normen und der Identität unseres Unternehmens.

3. Der Kunde verfügt über eine Datenbank mit Dokumentationen aller seiner APIs, die sich an einem mit dem Entwicklungsteam geteilten Endpunkt zur Abfrage befinden.

Dieses Repository

Dieses Repository enthält eine MCP-Server-Vorlage, die verwendet werden kann, um:

• Die Implementierung der Transporte stdio und HTTP mit @modelcontextprotocol/server zu verstehen;

• Die Kommunikation zwischen KI-Systemen und jedem externen Dienst zu simulieren;

• Als Inspiration für die Implementierung eines echten MCP-Servers zu dienen;

• Der Einstiegspunkt für die Verwendung von KI-Agenten mit benutzerdefinierten Tools zu sein.

Repository-Struktur

/servers

Beispiel-MCP-Server, die verschiedene Transporte und Frameworks verwenden.

• /servers/stdio

Bietet MCP-Nachrichten über stdin und stdout als untergeordneter Prozess an.

• /servers/http

Bietet MCP-Nachrichten über HTTP-Anfragen an, unter Verwendung des nativen HTTP-Moduls von Node.js.

• /servers/express

Bietet MCP-Nachrichten über HTTP-Anfragen an, unter Verwendung des Express-Frameworks.

/tools

Beispiele für benutzerdefinierte Tools, die von KI-Agenten verwendet werden können, um mit anderen Systemen zu interagieren.

• /tools/index.js

Zentralisiert und exportiert alle Tools des Repositorys, damit die MCP-Server sie einheitlich registrieren können.

• /tools/nordesul-deploy

Gibt wesentliche Vorsichtsmaßnahmen und Best Practices für ein sicheres Deployment beim Kunden Nordesul zurück.

• /tools/nordesul-delivery

Simuliert Implementierungsmuster und -verträge für das Projekt.

• /tools/nordesul-reference

Simuliert die Abfrage einer API-Dokumentation beim Kunden Nordesul.

• /tools/nordesul-status

Simuliert die Abfrage des Status einer Anwendung beim Kunden Nordesul.

/utils

Zentralisiert Hilfs-/gemeinsame Funktionen des Projekts.

/.opencode

Konfigurationsverzeichnis von Opencode, enthält einen benutzerdefinierten Agenten mentor, um den Workshop-Teilnehmern zu helfen, das Repository und seine Funktionen zu verstehen.

Projekt ausführen

Voraussetzungen

• Git;

• Das Workshop-Repository klonen;

• Opencode (oder ein anderer KI-Agent, der MCP unterstützt) installiert und konfiguriert;

• Node.js (>= LTS bevorzugt)

• Paketmanager (npm oder yarn)

Abhängigkeiten installieren

Führen Sie im Projektstammverzeichnis den folgenden Befehl aus:

npm install

# ou:

yarn install

Server ausführen

MCP-Server über stdio:

npm run start:stdio

# ou:

yarn start:stdio

MCP-Server über http:

npm run start:http

# ou:

yarn start:http

MCP-Server über Integration mit Express:

npm run start:express

# ou:

yarn start:express

Mentor-Agent ausführen (Beispiel mit Opencode)

Öffnen Sie bei installiertem Opencode ein Terminal Ihrer Wahl im Repository-Verzeichnis und führen Sie den folgenden Befehl aus:

opencode

Die erste Ausführung lädt alle Abhängigkeiten von Opencode herunter. Warten Sie daher, bis der Vorgang abgeschlossen ist. Der Mentor-Agent ist bereits standardmäßig ausgewählt.

Integration von MCP-Servern mit KI-Agenten

• Opencode: MCP-Server;

• Claude: Claude Code über MCP mit Tools verbinden;

• Codex: Model Context Protocol;

• Cursor: Model Context Protocol (MCP);

• Antigravity: Model Context Protocol (MCP).

Beispiel-Prompts

Einige Beispiele für die Interaktion mit den Tools des Repositorys über Ihren Agenten:

nordesul-delivery

Quais são os padrões de implementação para a área de checkout do Nordesul?

nordesul-deploy

Antes de eu publicar essa mudança no Nordesul, quais cuidados devo tomar?

nordesul-reference

Me mostra a documentação da API de pedidos (orders) do Nordesul.

nordesul-status

Qual o status atual da aplicação checkout-service no Nordesul?