gtrmarket-mcp

Ein Model Context Protocol-Server für die gtrmarket-API: das Nissan-Skyline-GT-R-Produktionsregister, ein Teile-Kompatibilitätsgraph, Live-Marktplatzangebote und ein durchsuchbarer Index von zwei Jahrzehnten Skyline-Forumsthreads.

Er existiert, weil es sich um Fakten handelt, und ein Sprachmodell, das aus dem Gedächtnis antwortet, wird sie auf subtile Weise falsch wiedergeben. Produktionszahlen, Teilenummern, was an einen BNR34 passt und was nicht — das alles hat Quellen, und ein Assistent sollte sie lesen, statt sie aus dem Gedächtnis abzurufen.

Installation

Fügen Sie ihn Ihrem MCP-Client hinzu. Für Claude Desktop oder Claude Code:

{
  "mcpServers": {
    "gtrmarket": {
      "command": "npx",
      "args": ["-y", "gtrmarket-mcp"],
      "env": {
        "GTRMARKET_API_KEY": "gtrm_live_..."
      }
    }
  }
}

Erstellen Sie einen Schlüssel unter https://gtrmarket.com/settings/developer. Ein schreibgeschützter Schlüssel mit market:read, registry:read, parts:read und archive:read ist alles, was dieser Server braucht, und genau den empfehlen wir — siehe Sicherheit.

Das Geheimnis wird nur einmal angezeigt und nie wieder; fügen Sie es daher in Ihre Konfiguration ein, bevor Sie die Seite schließen.

Related MCP server: groq-docs-mcp

Werkzeuge

Sicherheit

Jedes Werkzeug ist schreibgeschützt. Nichts hier postet, bearbeitet, kauft oder löscht. Ein Assistent, der suchen kann, ist in Ordnung; einer, der Ihr Auto zum Verkauf einstellen kann, ist eine andere Entscheidung, und sie sollte bewusst von jemandem getroffen werden, der den Code gelesen hat — nicht durch die Installation eines MCP-Servers geerbt werden.

Es ist ein dünner Wrapper. Jedes Werkzeug bildet genau einen dokumentierten Endpunkt der öffentlichen API ab. Es gibt nichts, was dieser Server kann, das Sie nicht auch mit curl tun könnten — genau das macht es vertretbar, ihm einen Schlüssel zu geben. Lesen Sie src/tools.ts, bevor Sie das tun; es ist kurz.

Ihr Schlüssel schränkt es weiter ein. Ein gtrmarket-API-Schlüssel kann nie mehr können als das Konto, das ihn erstellt hat, und seine Scopes grenzen es weiter ein. Geben Sie diesem Server einen Schlüssel mit nur den Lese-Scopes, und er kann nicht schreiben, selbst wenn Sie ihn darum bäten.

Namensnennung

Das Archiv ist ein Index der Foren anderer Leute, keine Kopie davon. Jedes Ergebnis enthält seine Quelle und einen Link zurück, und wo wir keine Erlaubnis haben, die Beiträge zu reproduzieren, ist ein Ergebnis nur ein Titel und ein Link — nichts weiter. Wenn Sie diese Ergebnisse anzeigen, zeigen Sie die Quelle und verlinken Sie zurück — unter denselben Bedingungen, unter denen wir arbeiten.

Das Register, der Kompatibilitätsgraph und die Produktionszahlen existieren, weil Mitglieder sie beigesteuert haben. Bauen Sie darauf auf; behalten Sie die Namensnennung bei.

Konfiguration

GTRMARKET_API_URL ist für Tests gegen eine lokale Instanz gedacht. Sie werden diese URL nicht benötigen.

Ratenlimits

Ein kostenloser Schlüssel erlaubt 60 Anfragen pro Minute und 5.000 pro Tag. Einige Werkzeuge kosten mehr als eine Anfrage aus diesem Budget: search_archive und check_compatibility kosten 5, die Suchwerkzeuge kosten 2. Wenn Sie das Limit erreichen, gibt der Server eine entsprechende Meldung zurück, statt still zu scheitern, sodass der Assistent es Ihnen mitteilen kann.

Alle Details: https://gtrmarket.com/developers/en/guides/rate-limits

Entwicklung

npm install
npm run build
GTRMARKET_API_KEY=gtrm_live_... node dist/index.js

Der Server spricht MCP über stdio. stdout ist der Protokollkanal — alles, was dort geschrieben wird, beschädigt ihn, weshalb jede Diagnose an stderr geht.

Dokumentation

• API-Referenz und Anleitungen: https://gtrmarket.com/developers

• OpenAPI-Beschreibung: https://gtrmarket.com/api/v1/openapi.json

Lizenz

MIT. Siehe LICENSE.