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

Verwendet @vercel/mcp-adapter mit einem konfigurierbaren MCP-Register

Bereitgestellte URL

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

Related MCP server: Example Next.js MCP Server

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

Beispielclient

• scripts/test-client.mjs enthält einen Beispielclient zum Ausprobieren von Aufrufen.

node scripts/test-client.mjs https://nextjs-mcp-use.vercel.app