JVLink MCP服务器
只要和Claude搭话，就可以自由分析赛马数据。
你不用写SQL。如果用自然的日语提问的话，可以调查过去的比赛结果、骑手成绩、血统倾向等所有的赛马数据。
你可以问这样的问题
“最受欢迎的胜率是多少？”
| 出走数 | 胜利数 | 胜率 |
|---|---|---|
| 6,294 | 2,474 | 39.3% |
“今年获胜最多的骑手是？”
| 骑手 | 骑乘数 | 胜利 | 胜率 |
|---|
｜勒梅尔｜537｜142｜26.4%｜ | 戸崎圭太 | 832 | 135 | 16.2% | | 松山弘平 | 863 | 125 | 14.5% | | 坂井瑠星 | 729 | 119 | 16.3% | | 川田将雅 | 542 | 118 | 21.8% |
“产驹获胜较多的种马是？”
| 种牡马 | 出走数 | 胜利 |
|---|
\\37717Ï 加载加那罗亚\[1633\]\[178\] 电话，电话 \[表法内亚\]1488\]\[138\] 真实斯蒂尔=106=125｜
你还可以问其他这样的问题
- 东京草坪1600m内框和外框，哪个有利？
- 请告诉我G1比赛中最受欢迎的比赛
- 在深冲击产驹的草坪的成绩？
- 马体重500公斤以上的马的成绩是？
- 调查以最快速度获胜的马
______________________________________________________________________
单行安装
在交互式安装程序中，克隆-从属解决-数据库搜索-客户端设置一次即可完成。
macOS/Linux：
curl -fsSL https://raw.githubusercontent.com/miyamamoto/jvlink-mcp-server/master/install.sh | bashWindows（PowerShell）：
irm https://raw.githubusercontent.com/miyamamoto/jvlink-mcp-server/master/install.ps1 | iex💡 找不到keiba.db时、在浏览器中自动打开JRA-VAN DataLab的合同页面。也可以选择同时安装jrvltsql。
______________________________________________________________________
手动安装
Step1:创建赛马数据库
jrvltsql 从JRA-VAN获取数据keiba.db来修改标记元素的显示属性。
JRA-VAN 数据实验室 的合同→ https://jra-van.jp/dlb/ 如果你需要地方赛马数据 地方竞马DATA → https://www.keiba-data.com/
第2步：克隆存储库
git clone https://github.com/miyamamoto/jvlink-mcp-server.git
cd jvlink-mcp-server
pip install uv
uv syncStep3:设置为MCP客户端
请根据您的客户机参考以下部分。
💡 初回起动时将条目添加到文档注册表。
______________________________________________________________________
按MCP客户端设置
克劳德桌面版
claude_desktop_config.json 添加到：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"jvlink": {
"command": "uv",
"args": ["run", "--directory", "/path/to/jvlink-mcp-server", "python", "-m", "jvlink_mcp_server.server"],
"env": {
"DB_TYPE": "sqlite",
"DB_PATH": "/path/to/keiba.db"
}
}
}
}对于Windows:command的"uv.exe"中所述修改相应参数的值。发布 的，之.mcpb使用文件也可以自动安装。
______________________________________________________________________
克劳德代码（CLI）
claude mcp add jvlink \
-e DB_TYPE=sqlite \
-e DB_PATH=/path/to/keiba.db \
-- uv run --directory /path/to/jvlink-mcp-server python -m jvlink_mcp_server.server添加到项目范围 -s project 来修改标记元素的显示属性。
______________________________________________________________________
光标
项目根目录 .cursor/mcp.json 创建：
{
"mcpServers": {
"jvlink": {
"command": "uv",
"args": ["run", "--directory", "/path/to/jvlink-mcp-server", "python", "-m", "jvlink_mcp_server.server"],
"env": {
"DB_TYPE": "sqlite",
"DB_PATH": "/path/to/keiba.db"
}
}
}
}Cursor Settings→请确保MCP检测到服务器。
______________________________________________________________________
VS代码+GitHub副本
.vscode/mcp.json 创建：
{
"servers": {
"jvlink": {
"command": "uv",
"args": ["run", "--directory", "/path/to/jvlink-mcp-server", "python", "-m", "jvlink_mcp_server.server"],
"env": {
"DB_TYPE": "sqlite",
"DB_PATH": "/path/to/keiba.db"
}
}
}
}在VS Code的设置中 "chat.mcp.enabled": true 来修改标记元素的显示属性。
______________________________________________________________________
帆板运动
Windsurf Settings→从MCP中选择Add custom server~/.codeium/windsurf/mcp_config.json 添加到：
{
"mcpServers": {
"jvlink": {
"command": "uv",
"args": ["run", "--directory", "/path/to/jvlink-mcp-server", "python", "-m", "jvlink_mcp_server.server"],
"env": {
"DB_TYPE": "sqlite",
"DB_PATH": "/path/to/keiba.db"
}
}
}
}______________________________________________________________________
Codex CLI（OpenAI）
# codex の設定ファイル (~/.codex/config.yaml) に追加するか、
# MCP_SERVERS 環境変数で指定
export MCP_SERVERS='[{"name":"jvlink","transport":{"type":"stdio","command":"uv","args":["run","--directory","/path/to/jvlink-mcp-server","python","-m","jvlink_mcp_server.server"],"env":{"DB_TYPE":"sqlite","DB_PATH":"/path/to/keiba.db"}}}]'
codex______________________________________________________________________
其他MCP客户端
任何客户机的通用配置模式：
| 项目 | 値 |
|---|---|
| 命令 | uv |
| 引数 | run --directory /path/to/jvlink-mcp-server python -m jvlink_mcp_server.server |
| 环境变数 | DB_TYPE=sqlite, DB_PATH=/path/to/keiba.db |
| 协议 | 站立 |
______________________________________________________________________
数据库设置
SQLite（推奨）
DB_TYPE=sqlite
DB_PATH=/path/to/keiba.dbDuckDB
DB_TYPE=duckdb
DB_PATH=/path/to/keiba.duckdbPostgreSQL
在单独的环境变量中指定：
DB_TYPE=postgresql
DB_HOST=localhost
DB_PORT=5432
DB_NAME=keiba
DB_USER=postgres
DB_PASSWORD=your_password或连接字符串：
DB_TYPE=postgresql
DB_CONNECTION_STRING=host=localhost;port=5432;database=keiba;username=postgres;password=your_password______________________________________________________________________
在Mac/Linux中使用时
JRA-VAN的数据取得（jrvltsql）是Windows专用的如果你把数据库拿到Mac/Linux上此MCP服务器工作。
方法1:复制SQLite文件 —Dropbox、Google Drive等 keiba.db 只复制。
方法2: PostgreSQL経由 -jrvltsql还支持对PostgreSQL的写入。从Mac/Linux连接到Windows的PostgreSQL，可以实时使用最新数据。
______________________________________________________________________
NAR（地方竞马）对应
作为标准功能对应地方赛马数据（NAR对应工具： nar_favorite_performance, nar_jockey_stats, nar_horse_history）。可以分析大井、船桥、川崎、浦和、名古屋、园田等主要地方赛马场的数据。
地方赛马ー取得 NV链接 中所述修改相应参数的值。
______________________________________________________________________
使用方法的诀窍
｜诀窍｜说明｜ |-----|------| | 轻松愉快地提问 请直接问一下想到的事情 | 添加条件 如果缩小“东京的”“草坪的”“1600m的”等条件，就会进行详细的分析 | 请求比较 也擅长“比较A和B”“显示不同年度的推移” | 深挖 看了回答后在意的话继续提问。通过对话加深分析
→想看更多的提问例子的情况下 示例问题集
______________________________________________________________________
故障排除
服务器未启动
uv已安装：uv --version- 验证路径是否正确：
DB_PATH文件是否存在 - 重新安装从属关系：
cd /path/to/jvlink-mcp-server && uv sync
无法获取数据
keiba.db确认是否正确创建- 表是否存在：
sqlite3 keiba.db ".tables"确认 - 检查MCP客户端日志
PostgreSQL连接错误
- 确认PostgreSQL是否启动
- 检查防火墙是否打开端口
DB_CONNECTION_STRING确认格式（分号分隔符）
______________________________________________________________________
关于JRA-VAN数据的利用
本软件分析的数据JRA-VAN中所述修改相应参数的值。
禁止事项： 重新分发数据、提供给第三方、共享数据库文件
允许使用： 个人的赛马分析·研究，在本公司内的利用
了解更多信息 JRA-VAN利用规约 查看项目中可用的所有族。
更新履歴
v0.5.0（2026-04-18）
- 安全性：表名、列名的SQL注入防止验证（
validate_identifier()），模板名称将采用不同的格式 - 安全性：PostgreSQL的
get_table_schema()中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积 - 错误修复：
sample_data_provider.py修改的NL_SE过滤条件（KakuteiJyuni > 0、INTEGER型対応） - 错误修复：
high_level_api.py删除的GRADE_CODES重复密钥 - 错误修复：
_horse_history_impl不需要的类型转换pd.to_numeric统一 - 重命名工具：MCP工具
generate_sql_from_natural_language→get_sql_generation_prompt - 将NAR（地方赛马）对应整合到master分支（不需要其他分支）
- CI/CD：按PR自动测试（
ci.yml）和jrvltsql架构同步自动发布（sync-parent.yml），模板名称将采用不同的格式
许可证
- 商用利用: 请事先咨询→oracle.datascientist@gmail.com
- 非商用利用: Apache许可证2.0