Headless MCP-Nutzung (aus der Registry) mit Next.js

Verwendet

Bereitgestellte URL

Diese Anwendung wird bereitgestellt unter: https://nextjs-mcp-use.vercel.app

Related MCP server: Vercel MCP

Merkmale

MCP-Registrierung : Konfigurieren Sie mehrere MCP-Server in einer einzigen JSON-Datei
GitHub Actions : Testen und überwachen Sie Ihre API-Endpunkte mit geplanten und manuellen Workflows
Fehlerbehandlung : Sanfte Behandlung von Timeouts und Verbindungsfehlern
Umgebungsvariablen : Konfigurieren Sie Umgebungsvariablen für jeden MCP-Server

MCP-Registrierung

Die MCP-Registrierung ist eine JSON-Konfigurationsdatei, die Informationen zu allen verfügbaren MCP-Servern speichert. Jeder Server kann aktiviert oder deaktiviert werden und über eigene Umgebungsvariablen verfügen.

Die Registrierung befindet sich unter config/mcp-registry.json und hat die folgende Struktur:

{ "server-name": { "url": "http://localhost:3002/sse", "enabled": true, "env": { "API_KEY": "your-api-key" } }, "another-server": { "url": "https://example.com/sse", "enabled": false } }

Verwendung

Diese Beispiel-App verwendet den Vercel MCP-Adapter , mit dem Sie einen MCP-Server in eine Gruppe von Routen in jedem Next.js-Projekt einfügen können.

Aktualisieren Sie app/[transport]/route.ts mit Ihren Tools, Eingabeaufforderungen und Ressourcen gemäß der MCP TypeScript SDK-Dokumentation .

API-Endpunkte

Chat-API : /api/chat – Streaming-Chat-Endpunkt
Completions-API : /api/completions – Endpunkt für nicht gestreamte Chat-Completions

Testen der API

Sie können die API-Endpunkte mit dem bereitgestellten Testskript testen:

# Test the chat endpoint npm run test:chat -- --message "Your message here" # Test the completions endpoint npm run test:completions -- --message "Your message here" # Test with a custom URL npm run test:chat -- --url http://localhost:3000/api/chat --message "Your message here"

GitHub-Aktionen

Dieses Projekt umfasst GitHub Actions-Workflows zum Testen und Überwachen der API-Endpunkte. Weitere Informationen finden Sie in der Datei .github/workflows/README.md .

Hinweise zum Ausführen auf Vercel

Um den SSE-Transport zu verwenden, ist ein Redis erforderlich, das unter process.env.REDIS_URL an das Projekt angehängt ist.
Stellen Sie sicher, dass Fluid Compute für eine effiziente Ausführung aktiviert ist
Nachdem Sie Fluid Compute aktiviert haben, öffnen Sie app/route.ts und passen Sie maxDuration auf 800 an, wenn Sie ein Vercel Pro- oder Enterprise-Konto verwenden
Bereitstellen der Next.js MCP-Vorlage