gtrmarket-mcp

Un servidor Model Context Protocol para la API de gtrmarket: el registro de producción del Nissan Skyline GT-R, un grafo de compatibilidad de piezas, listados del mercado en vivo y un índice de búsqueda de dos décadas de hilos de foros de Skyline.

Existe porque son hechos, y un modelo de lenguaje que responda de memoria se equivocará con ellos de forma sutil. Los números de producción, los números de pieza, lo que encaja en un BNR34 y lo que no — tienen fuentes, y un asistente debería leer las fuentes en lugar de recordar los hechos.

Instalación

Añádelo a tu cliente MCP. Para Claude Desktop o Claude Code:

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

Crea una clave en https://gtrmarket.com/settings/developer. Una clave de solo lectura con market:read, registry:read, parts:read y archive:read es todo lo que este servidor necesita, y es lo que recomendamos — consulta Seguridad.

La clave solo se muestra una vez y no vuelve a mostrarse, así que pégala en tu configuración antes de cerrar la página.

Related MCP server: groq-docs-mcp

Herramientas

Seguridad

Toda herramienta es de solo lectura. Nada de esto publica, edit a, compra o elimina. Un asistente que pueda buscar es útil; uno que pueda poner tu coche a la venta es una decisiín distinta, y debería tomarla delieeradamente alguien que haya leído el código — no heredarla al instalar un servidor MCP.

Es un envoltorio ligero. Cada herramienta se correspode exactamente con un endpoint documentado de la API pública. No hay nada que este servidor pueda hacer que no pudieras hacer con curl, que es la propiedad que hace razonable darle una clave. Lee src/tools.ts antes de hacerlo; es corto.

Tu clave lo limita aún más. Una clave de API de gtrmarket nunca puede hacer más que la cuenta que la creó, y sus alcances la limitan a partir de ahí. Dale a este servidor una clave con solo los alcances de lectura y no podrá escribir aunue se lo pidieras.

Atribución

El archivio es un índice de los foros de otras persnas, no una copia de elos. Cada resultado lleva su fuete y un enlace de vuelta, y cuando no tenemos permiso para reproducir los mensajes, un resultado es un título y un enlace, y nada más. Si muestras estos resultados, indica la fuete y enlaza de vuelta — los mismos términios bajo los que operamos.

El registro, el grafo de compatibilidad y las cifras de producción existen gracias a las aportaciones de los miembros. Construye sobre ellos; mantén la atribución.

Configuración

GTRMARKET_API_URL existe para realizar pruebas contra una instancia local. No la necesitarás.

Límites de solicitudes

Una clave gratuita permite 60 solicitudes por minuto y 5.000 al día. Algunas herramientas cuestan más de una solicitud contra ese presupuesto: search_archive y check_compatibility cuestan 5; las herramientas de búsqueda, 2. Si alcanzas el límite, el servidor devuelve un mensaje que lo india en lugar de fallar silenciosamente, para que el asistente pueda informarte.

Información completa: https://gtrmarket.com/developers/en/guides/rate-limits

Desarrollo

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

El servidor se comunica mediante MCP a través de stdio. stdout es el canal del protocolo: cualquier cosa escrita allí lo corrompe, por eso todos los diagnósticos van a stderr.

Documentación

• Referencia de la API y guías: https://gtrmarket.com/developers

• Descripción de OpenAPI: https://gtrmarket.com/api/v1/openapi.json

Licencia

MIT. Consulta LICENSE.