gtrmarket-mcp

gtrmarket API를 위한 Model Context Protocol 서버입니다: Nissan Skyline GT-R 생산 레지스트리, 부품 장착 그래프, 실시간 마켓플레이스 목록, 그리고 20년치 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

서버는 stdio를 통해 MCP를 사용합니다. stdout은 프로토콜 채널입니다. 거기에 쓰여진 것은 무엇이든 그 채널을 손상시키므로, 모든 진단 정보는 stderr로 출력됩니다.

문서

• API 참조 및 가이드: https://gtrmarket.com/developers

• OpenAPI 설명: https://gtrmarket.com/api/v1/openapi.json

라이선스

MIT. LICENSE를 참조하세요.