Golf Intelligence, by Stracka

Golf Intelligence, by Stracka. 골프 앱을 개발하는 개발자를 위한 최고 품질의 골프 코스 데이터셋입니다. 20년간의 독점 매핑(레이저, 드론, 항공기, 위성)을 기반으로 매일 업데이트됩니다. 검색은 무료입니다. API를 통해 스코어카드, GPS, 3D 그린을 제공합니다. 스크래핑이 아닙니다.

Golf Intelligence는 코스별 매핑을 통해 구축된 독점 데이터셋으로, GitHub 골프 코스 API의 클론이 아닙니다. 10명의 인력이 매일 매핑하며, 데이터는 2007년부터 지속적으로 업데이트되고 있습니다. 자세한 내용은 golfintelligence.com에서 확인하세요.

이 저장소는 핸들 golf를 사용하는 설치 가능한 Cursor / Grok Bot 플러그인입니다. Cursor 마켓플레이스 애플리케이션 소스는 공개 GitHub URL입니다:

https://github.com/golf-data/golf

마켓플레이스 검토자는 해당 URL을 cursor.com/marketplace/publish에 제출할 수 있습니다. 카탈로그 제목은 Golf Intelligence, by Stracka입니다.

공식 MCP 레지스트리 이름은 **io.github.golf-data/golf**입니다. 레지스트리는 단순한 golf 이름을 허용하지 않습니다. Cursor, Agent Plugins, Claude Code 플러그인 핸들은 golf로 유지됩니다.

API 액세스 받기

console.golfintelligence.com에서 API 계정을 만든 다음, 플러그인의 두 필수 변수를 구성하세요:

• GI_CLIENT_ID: 귀하의 클라이언트 ID

• GI_ACTIVE_TOKEN: 귀하의 활성 토큰

활성 토큰은 수명이 짧은 베어러 토큰으로 교환됩니다. 이는 베어러 토큰이 아닙니다. GI_ACTIVE_TOKEN에 베어러 토큰을 붙여넣지 마세요.

요금제:

• Personal: 자신의 게임용 Cursor, Grok 또는 Claude 앱을 위한 50개의 테스트 크레딧에 $49. Personal 구매.

• Starter: 다른 사용자에게 앱을 출시할 때 10,000 크레딧에 월 $399. data@golfintelligence.com로 이메일을 보내세요. Starter에는 결제 링크가 없습니다.

데이터, 요금제 또는 통합에 대한 문의: data@golfintelligence.com.

Related MCP server: loyaltyvip

도구 및 크레딧

항상 먼저 검색하세요. search_course_groups는 무료입니다. 모든 유료 호출 전에 사용자는 명시된 비용을 명시적으로 확인해야 합니다. 서버는 confirm_spend=true가 아니면 유료 도구를 거부합니다.

인증

서버는 구성된 자격 증명을 다음 엔드포인트와 교환합니다:

POST https://api.golfintelligence.com/auth/authenticateToken
grant_type=client_credentials
code=<GI_ACTIVE_TOKEN>
client_id=<GI_CLIENT_ID>

반환된 access_token을 Authorization: Bearer <access_token>로 전송하고, 메모리에만 캐시하며, HTTP 401 후 한 번 갱신합니다. 자격 증명은 절대 로그에 기록되지 않습니다.

Streamable HTTP

프로덕션 HTTP 엔드포인트는 /mcp에서 공식 MCP Streamable HTTP 전송을 제공하고 /health에서 상태 확인을 제공합니다. 의도된 사용자 정의 도메인 URL 형태는 다음과 같습니다:

https://mcp.golfintelligence.com/mcp

이 저장소는 해당 URL이 실제로 운영 중이라고 주장하지 않습니다. 검토를 위해 제출하기 전에 DNS 및 배포가 완료되어야 합니다. HTTP 서버를 로컬에서 시작하려면 다음을 실행하세요:

npm run build
PORT=3000 npm run start:http

이 서버는 0.0.0.0:$PORT에 바인딩됩니다. 기존 node dist/index.js stdio 엔트리포인트와 모든 플러그인 패키지는 변경되지 않습니다.

HTTP 서비스는 Golf Intelligence 자격 증명을 다음 순서로 확인합니다:

1. X-GI-Client-ID 및 X-GI-Active-Token HTTP 헤더를 모든 MCP 요청에 함께 제공합니다.

2. 서버 측 GI_CLIENT_ID 및 GI_ACTIVE_TOKEN 환경 변수.

Codex는 Streamable HTTP MCP 서버에 대해 정적 http_headers 및 환경 기반 env_http_headers를 지원합니다. OpenAI 검토를 위해 전용 검토 API 계정을 배포 환경 변수로 구성하거나, 검토 구성이 지원하는 경우 두 개의 사용자 정의 헤더를 제공하세요. 활성 토큰은 교환 자격 증명으로 유지되며 Authorization: Bearer 값으로 전송되어서는 안 됩니다. 프로덕션 배포는 환경 기반 자격 증명이 공개 엔드포인트의 모든 호출자에게 조회 도구를 제공하므로 적절한 크레딧 한도가 있는 전용 계정을 사용해야 합니다.

모든 도구는 다음 MCP 주석을 명시적으로 표시합니다:

• readOnlyHint: true — 각 도구는 코스 데이터만 검색합니다.

• openWorldHint: false — 어떤 도구도 공개 또는 외부 시스템에 쓰지 않습니다.

• destructiveHint: false — 어떤 도구도 삭제, 덮어쓰기, 게시 또는 전송하지 않습니다.

• idempotentHint: true — 조회를 반복해도 추가 부작용이 없습니다.

이 문장들은 OpenAI 제출 양식의 주석 근거로도 사용할 수 있습니다. 유료 조회는 위에 문서화된 동일한 크레딧 비용으로 여전히 confirm_spend=true가 필요합니다.

컨테이너 배포

Dockerfile은 자격 증명을 포함하지 않고 두 전송을 모두 빌드합니다. fly.toml은 소규모 Fly.io 서비스를 구성하고 /health를 확인합니다. 첫 배포 전에 전역적으로 고유한 Fly 앱 이름을 사용할 수 있는지 확인하고(또는 app을 변경), 런타임 비밀을 설정한 후 배포하세요:

fly secrets set GI_CLIENT_ID=... GI_ACTIVE_TOKEN=...
fly deploy

배포된 *.fly.dev 엔드포인트가 MCP Inspector 검사를 통과한 후에만 사용자 정의 도메인을 설정하세요. 이 저장소는 배포를 수행하지 않습니다.

저장소 구조

• .cursor-plugin/plugin.json — Cursor 마켓플레이스 매니페스트 및 필수 변수

• plugin.json — Agent Plugins 개방형 표준 매니페스트 (핸들 golf)

• .claude-plugin/plugin.json — Claude Code / Cowork 플러그인 매니페스트 (핸들 golf)

• server.json — 공식 MCP 레지스트리 메타데이터 (io.github.golf-data/golf)

• manifest.json — stdio Node 서버용 MCPB 번들 매니페스트

• .github/workflows/publish-mcp.yml — GitHub OIDC를 통해 io.github.golf-data/golf를 공식 MCP 레지스트리에 게시

• mcp.json — 번들된 golf MCP 서버 구성

• skills/golf/SKILL.md — 워크플로 및 지출 확인 지침

• src/ — TypeScript MCP 서버 및 API 클라이언트

• dist/index.js — 설치 프로그램이 사용하는 커밋된 stdio ESM 번들

• dist/http.js — 컨테이너가 사용하는 커밋된 Streamable HTTP ESM 번들

• Dockerfile 및 fly.toml — 프로덕션 HTTP 컨테이너 및 Fly.io 서비스

Node.js 18 이상으로 개발하려면:

npm install
npm test
npm run build
npm run pack:mcpb

pack:mcpb는 공식 @anthropic-ai/mcpb pack CLI를 사용하여 golf.mcpb를 생성하고 그 SHA-256을 server.json에 기록합니다. GitHub Releases는 해당 자산을 https://github.com/golf-data/golf/releases/download/v1.0.0/golf.mcpb에 호스팅합니다.

플러그인 코드는 MIT 라이선스로 제공됩니다. Golf Intelligence API 데이터는 golfintelligence.com의 약관이 적용됩니다.