TP5 MCP Streamable HTTP Demo

Dieses Projekt bildet das Demo-Ziel nach:

• MCP-Server, der zwei Tools bereitstellt.

• Test mit @modelcontextprotocol/inspector.

• LangChain/LangGraph-kompatibler Agent, der MCP über Streamable HTTP nutzt.

• n8n AI Agent-Einrichtung unter Verwendung von MCP über Streamable HTTP.

Wichtiger Sicherheitshinweis

Der im Prompt eingefügte OpenAI-Schlüssel wurde im Chat offengelegt. Widerrufen Sie ihn und erstellen Sie einen neuen Schlüssel, bevor Sie den Agenten ausführen. Tragen Sie den neuen Schlüssel in .env ein; committen Sie ihn nicht.

Einrichtung

Copy-Item .env.example .env
npm install

Bearbeiten Sie .env und setzen Sie:

OPENAI_API_KEY=your_new_key

Starten des MCP-Servers

npm run server

Der MCP-Endpunkt lautet:

http://127.0.0.1:3000/mcp

Der Health-Endpunkt lautet:

http://127.0.0.1:3000/health

Test mit MCP Inspector

Lassen Sie den Server in einem Terminal laufen:

npm run server

Listen Sie in einem anderen Terminal die Tools mit dem Inspector CLI auf:

npm run inspector:list-tools

Unter Windows kann das aktuelle Inspector CLI die korrekte JSON-Antwort ausgeben und dann mit einer Node/libuv-Assertion beendet werden. Wenn Sie das tools-JSON sehen, das calculate und text_stats enthält, war der MCP-Aufruf selbst erfolgreich.

Rufen Sie ein Tool mit dem Inspector CLI auf:

npx --yes @modelcontextprotocol/inspector --cli http://127.0.0.1:3000/mcp --transport http --method tools/call --tool-name calculate --tool-arg operation=add --tool-arg "numbers=[2,3,4]"

Sie können auch die Inspector-Benutzeroberfläche öffnen:

npm run inspector

Wählen Sie dann:

Transport: Streamable HTTP
URL: http://127.0.0.1:3000/mcp

Lokaler Smoke-Test

npm run smoke

Dies listet die MCP-Tools auf und ruft calculate auf.

LangChain-Agent

Stellen Sie sicher, dass der Server läuft und .env einen gültigen, rotierten OPENAI_API_KEY enthält.

npm run agent

Benutzerdefinierter Prompt:

npm run agent -- "Calcule 42 / 6 puis analyse le texte: Bonjour depuis MCP."

n8n-Agent

Folgen Sie docs/n8n-agent.md.

Die Konfiguration des n8n MCP Client Tools lautet:

Endpoint: http://127.0.0.1:3000/mcp
Server Transport: HTTP Streamable
Authentication: None
Tools to Include: All