gtrmarket-mcp

Сервер Model Context Protocol для API gtrmarket: реестр выпущенных Nissan Skyline GT-R, граф совместимости запчастей, актуальные объявления маркетплейса и поисковый индекс форумных тредов Skyline за два десятилетия.

Он существует, потому что всё это — факты, а языковая модель, отвечающая по памяти, будет незаметно ошибаться в них. Объёмы производства, номера запчастей, что подходит к BNR34, а что нет, — у всего этого есть источники, и ассистент должен читать их, а не вспоминать.

Установка

Добавьте его в свой MCP-клиент. Для Claude Desktop или Claude Code:

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

Создайте ключ на https://gtrmarket.com/settings/developer. Этому серверу достаточно ключа только для чтения с правами market:read, registry:read, parts:read и archive:read — именно такой ключ мы и рекомендуем; см. Безопасность.

Секрет показывается только один раз и больше никогда, поэтому вставьте его в конфигурацию, прежде чем закрыть страницу.

Related MCP server: groq-docs-mcp

Инструменты

Безопасност

Каждый инструмент доступен только для чтения. Ни один инструмент здесь не публикует, не редактирует, не покупает и не удаляет. Ассистент, который умеет искать, полезен; ассистент, который может выставить ваш автомобиль на продажу, — это отдельное решение, и оно должно быть принято осознанно тем, кто прочитал код, а не унаследовано при установке MCP-сервера.

Это тонкая обёртка. Каждый инструмент соответствует ровно одному документированному эндпоинту публичного API. Этот сервер не умеет ничего такого, чего нельзя было бы сделать через curl, — именно это свойство делает разумным доверить ему ключ. Прежде чем сделать это, прочитайте src/tools.ts; он короткий.

Ваш ключ ограничивает его ещё сильнее. Ключ gtrmarket API никогда не может сделать больше, чем аккаунт, создавший его, а области доступа сужают эти возможности ещё дальше. Дайте серверу ключ только с правами на чтение — и записывать он не сможет, даже если вы его об этом попросите.

Атрибуция

Архив — это индекс чужих форумов, а не их копия. Каждый результат содержит источник и обратную ссылку, а там, где у нас нет разрешения воспроизводить сообщения, результат — это заголовок и ссылка, и ничего больше. Если вы показываете эти результаты, указывайте источник и давайте обратную ссылку — на тех же условиях, на которых работаем мы.

Реестр, граф совместимости запчастей и данные о производстве существуют благодаря вкладу участников. Стройте на их основе; сохраняйте атрибуцию.

Конфигурация

GTRMARKET_API_URL существует для тестирования с локальным экземпляром. Она вам не понадобится.

Лимиты запросов

Бесплатный ключ позволяет выполнять 60 запросов в минуту и 5 000 в день. Некоторые инструменты стоят дороже одного запроса в рамках этого бюджета: search_archive и check_compatibility стоят 5, инструменты поиска — 2. Если вы упрётесь в лимит, сервер вернёт сообщение об этом, а не промолчит, так что ассистент сможет сообщить вам об этом.

Подробная информация: https://gtrmarket.com/developers/en/guides/rate-limits

Разработка

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

Сервер общается по MCP через stdio. stdout — это канал протокола: всё, что в него записывается, повреждает его, поэтому вся диагностика направляется в stderr.

Документация

• Справочник API и руководства: https://gtrmarket.com/developers

• Описание OpenAPI: https://gtrmarket.com/api/v1/openapi.json

Лицензия

MIT. См. LICENSE.