KRA Racing Data Analysis MCP Server
About
It is an MCP (Model Context Protocol) server that analyzes horse racing data from the Korea Racing Authority (KRA) public API. It provides tools, resources, and prompts for race analysis, horse performance evaluation, jockey statistics, odds analysis, and track condition…
Details
- Author
- coyaSONG
- Downloads
- 437
- Categories
- Search
Jump to
- Analyze races by date, race number, and track.
- Evaluate horse performance and form.
- Retrieve jockey statistics and performance.
- Analyze odds, patterns, and market trends.
- Assess track condition and weather impact.
- Access race schedules, horse details, and track info via resources.
- Generate race predictions and performance reports via prompts.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
KRA Racing Data Analysis MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Node.js 18+, clone the repository, run npm install, set the KRA_SERVICE_KEY environment variable (obtained from data.go.kr), then run in dev mode with npm run dev or build and start with npm run build and npm start. Register the server in your MCP client (e.g., Cursor) by adding the appropriate command and path in the mcp.json file.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"kra racing data analysis mcp server": {
"kra-mcp": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"npx",
"tsx",
"src/index.ts"
]
}
}
}
}McpServers
{
"kra-mcp": {
"command": "npx",
"args": [
"@modelcontextprotocol/inspector",
"npx",
"tsx",
"src/index.ts"
]
}
}KRA Racing Data Analysis MCP Server
한국 마사회(Korea Racing Authority) 공공 API를 활용한 경마 데이터 분석 MCP 서버
이 프로젝트는 Model Context Protocol (MCP)을 사용하여 한국 마사회의 경마 데이터를 분석하고 인사이트를 제공하는 서버입니다.
🏇 주요 기능
🔧 분석 도구 (Tools)
- analyze-race: 경주 분석 (날짜, 경주번호, 경마장별) - analyze-horse-performance: 말 성적 분석 및 폼 평가 - get-jockey-stats: 기수 통계 및 성과 분석 - analyze-odds: 배당률 분석 및 패턴 인식 - analyze-track-condition: 주로 상태 및 날씨 영향 분석📁 데이터 리소스 (Resources)
- schedule://{date}: 경주 일정 정보 (오늘/내일) - horses://{horseName}: 말 상세 정보 및 기록 - tracks://{trackCode}: 경마장 정보 (서울/부산/제주) - config://kra-api: KRA API 설정 및 구성💬 분석 프롬프트 (Prompts)
- predict-race: 경주 예측 분석 (기본/상세/통계) - horse-performance-report: 말 성적 상세 리포트 - market-analysis: 마권 시장 분석 (배당률/거래량/트렌드)🎯 활용 분야
- 경주 예측: 데이터 기반 경주 결과 예측
- 투자 분석: 마권 투자 전략 수립
- 성과 평가: 말, 기수, 조교사 성과 분석
- 시장 분석: 배당률 및 거래량 패턴 분석
- 리스크 관리: 투자 리스크 평가 및 관리
📦 설치 및 설정
필수 요구사항
- Node.js 18.0.0 이상 - npm 또는 yarn - 한국 마사회 공공 API 접근 권한 ✅ 실제 연동 완료KRA API 키 설정 (필수)
1. 공공데이터포털 신청
- 공공데이터포털 접속
- "한국마사회 경주기록 정보" API 검색 및 신청
- 승인 후 서비스키 발급받기
2. 환경변수 설정
# Windows (PowerShell)
$env:KRA_SERVICE_KEY="YOUR_SERVICE_KEY_HERE"
# macOS/Linux
export KRA_SERVICE_KEY="YOUR_SERVICE_KEY_HERE"
# 또는 .env 파일 생성
echo "KRA_SERVICE_KEY=YOUR_SERVICE_KEY_HERE" > .env
3. 서비스키 확인
- URL 인코딩된 키를 사용해야 합니다
- 특수문자가 포함된 경우 인코딩 필요
프로젝트 설치
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
