KRA赛车数据分析MCP服务器
利用韩国马事会（Korea Racing Authority）公共API分析赛马数据的MCP服务器
该项目是使用Model Context Protocol（MCP）分析韩国马事会赛马数据并提供洞察的服务器。
🏇 主要功能
🔧 分析工具
- 分析种族：比赛分析（日期、比赛编号、赛马场类别）
- 分析马的表现：马成绩分析和表单评价
- 获取骑师统计数据：基数统计和绩效分析
- 获取骑师信息：查询基数信息
- 分析赔率：分红分析和模式识别
📁 数据资源（Resources）
- 日程安排：//{日期}：赛程信息（今天/明天）
- 马：//{horseName}：马详细信息和记录
- tracks://{trackCode}：赛马场信息（首尔/釜山/济州）
- config://kra-api：设置和配置KRA API
💬 分析提示（Prompts）
- 预测种族：比赛预测分析（基本/详细/统计）
- 马匹表现报告：马成绩详细报告
- 市场分析：马权市场分析（股息率/交易量/趋势）
🎯 应用领域
- 庆州预测：基于数据的比赛结果预测
- 投资分析：制定马权投资战略
- 绩效评估：马，骑手，助教成绩分析
- 市场分析：分析股息率和交易量模式
- 风险管理：投资风险评估和管理
📦 安装和设置
基本要求
- Node.js 18.0.0或更高版本
- npm或yarn
- 韩国马事会公共API访问权限 ✅ 实际联动完成
KRA API密钥设置（必需）
- 申请公共数据门户网站
- 公共数据门户 连接 - “韩国马事会比赛记录信息”API搜索和申请 - 获得批准后获得服务密钥
- 设置环境变量
# 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- 确认服务密钥
- 必须使用URL编码的密钥 - 如果包含特殊字符，则需要编码
安装项目
# 저장소 클론
git clone
cd kra-racing-data-mcp-server
# 의존성 설치
npm install
# KRA API 키 설정 (위 참조)
export KRA_SERVICE_KEY="your_service_key"🏃♂️ 执行方法
开发模式
npm run dev监视模式（更改文件时自动重新启动）
npm run watch生产构建和运行
npm run build
npm start🔧 注册MCP客户端
在Cursor IDE中使用
~/.cursor/mcp.json 添加到文件：
{
"mcpServers": {
"kra-racing-analysis": {
"command": "npx",
"args": ["tsx", "C:/Users/SONG/kra-racing-data-mcp-server/src/index.ts"]
}
}
}使用生产版本：
{
"mcpServers": {
"kra-racing-analysis": {
"command": "node",
"args": ["C:/Users/SONG/kra-racing-data-mcp-server/dist/index.js"]
}
}
}Cursor重新启动后可用。
🧪 测试和验证
使用MCP Inspector
npx @modelcontextprotocol/inspector npx tsx src/index.ts工具测试示例
# 경주 분석 테스트
analyze-race --raceDate="2024-01-15" --raceNumber="3" --trackCode="seoul"
# 말 성적 분석 테스트
analyze-horse-performance --horseName="우승마" --period="1year"📂 项目结构
kra-racing-data-mcp-server/
├── src/
│ └── index.ts # 메인 서버 파일
├── dist/ # 빌드된 JavaScript 파일
├── package.json # 프로젝트 설정
├── tsconfig.json # TypeScript 설정
├── .gitignore # Git 제외 파일
└── README.md # 프로젝트 문서🔍 使用示例
1.请求比赛分析
{
"method": "tools/call",
"params": {
"name": "analyze-race",
"arguments": {
"raceDate": "2024-01-15",
"raceNumber": 5,
"trackCode": "seoul"
}
}
}2.查询马信息
{
"method": "resources/read",
"params": {
"uri": "horses://우승마"
}
}3.庆州预测提示
{
"method": "prompts/get",
"params": {
"name": "predict-race",
"arguments": {
"raceDate": "2024-01-15",
"raceNumber": "5",
"analysisType": "detailed"
}
}
}🛠️ 开发指南
添加新的分析工具
server.tool("new-analysis-tool",
{
param1: z.string(),
param2: z.number().optional()
},
async ({ param1, param2 }) => ({
content: [{
type: "text",
text: `분석 결과: ${param1} ${param2 || ''}`
}]
})
);添加新的数据资源
server.resource(
"new-resource",
new ResourceTemplate("resource://{id}", { list: undefined }),
async (uri, { id }) => ({
contents: [{
uri: uri.href,
text: JSON.stringify({ id, data: "..." }, null, 2)
}]
})
);🌐 API集成情况
✅ 当前集成的API:
- 韩国马事会公共API：比赛信息、参赛数据、骑手信息
- API214_1：比赛详细结果和分析数据
- API12_1：查询基数信息
- API299：关于赛跑统计和预测
⏳ 未来联动计划:
- 实时分红API：跟踪赔率变化
- 气象信息API：主要分析状态影响
📊 数据分析功能
支持的分析类型
- 技术分析：基于过去成绩的模式分析
- 统计分析：概率模型和回归分析
- 市场分析：股息率和交易量分析
- 比较分析：马、骑手、助教之间的比较
预测模型（计划）
- 机器学习模型：基于历史数据的预测
- 合唱团模特：多模型联合预测
- 实时分析：比赛当天实时数据分析
🔒 安全性和合规性
- 遵守韩国马事会API使用条款
- 遵守个人信息保护法
- 安全的API密钥管理
- 遵守数据使用限制
📚 参考资料
📄 许可证
MIT许可证
______________________________________________________________________
⚠️ 重要：与实际的KRA公共API配合使用。需要设置API密钥。
💡 提示：与Context7配合使用可以获得更准确的赛马数据分析！在提示符下 use context7请添加。
