JVLink MCP Server

JVLink MCP服务器

只要和Claude搭话，就可以自由分析赛马数据。

你不用写SQL。如果用自然的日语提问的话，可以调查过去的比赛结果、骑手成绩、血统倾向等所有的赛马数据。

你可以问这样的问题

“最受欢迎的胜率是多少？”

“今年获胜最多的骑手是？”

｜勒梅尔｜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 | bash

Windows（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 sync

Step3:设置为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客户端

任何客户机的通用配置模式：

______________________________________________________________________

数据库设置

SQLite（推奨）

DB_TYPE=sqlite
DB_PATH=/path/to/keiba.db

DuckDB

DB_TYPE=duckdb
DB_PATH=/path/to/keiba.duckdb

PostgreSQL

在单独的环境变量中指定：

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”“显示不同年度的推移” | 深挖 看了回答后在意的话继续提问。通过对话加深分析

→想看更多的提问例子的情况下 示例问题集

______________________________________________________________________

故障排除

服务器未启动

1. uv 已安装： uv --version
2. 验证路径是否正确： DB_PATH 文件是否存在
3. 重新安装从属关系： cd /path/to/jvlink-mcp-server && uv sync

无法获取数据

1. keiba.db 确认是否正确创建
2. 表是否存在： sqlite3 keiba.db ".tables" 确认
3. 检查MCP客户端日志

PostgreSQL连接错误

1. 确认PostgreSQL是否启动
2. 检查防火墙是否打开端口
3. 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