jvlink-mcp-server

miyamamoto/jvlink-mcp-server

3.2

If you are the rightful owner of jvlink-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

JVLink MCP Server is a Model Context Protocol server designed to access and analyze horse racing databases created with JVLinkToSQLite.

JVLink MCP Server

Claudeに話しかけるだけで、競馬データを自由に分析できます。

SQLを書く必要はありません。自然な日本語で質問すれば、過去のレース結果、騎手成績、血統傾向など、あらゆる競馬データを調べられます。

こんな質問ができます

「1番人気の勝率はどのくらい？」

出走数勝利数勝率
6,2942,47439.3%

「今年勝ち星が多い騎手は？」

騎手騎乗数勝利勝率
ルメール53714226.4%
戸崎圭太83213516.2%
松山弘平86312514.5%
坂井瑠星72911916.3%
川田将雅54211821.8%

「産駒の勝ち星が多い種牡馬は？」

種牡馬出走数勝利
キズナ1,717207
ロードカナロア1,633178
ドレフォン1,382150
エピファネイア1,488138
リアルスティール1,106125

他にもこんな質問ができます

  • 東京芝1600mで内枠と外枠、どっちが有利？
  • G1レースで1番人気が飛んだレースを教えて
  • ディープインパクト産駒の芝での成績は？
  • 馬体重500kg以上の馬の成績は？
  • 上がり3F最速で勝った馬を調べて

クイックスタート（Windows）

3ステップで使い始められます

Step 1: 競馬データベースを作成

jrvltsql を使ってJRA-VANからデータを取得し、keiba.dbを作成します。

Step 2: MCPサーバーをインストール

Releasesから .mcpb ファイルをダウンロードしてダブルクリック。

Step 3: データベースを指定

Claude Desktopのインストール画面でkeiba.dbのパスを指定して完了！

💡 初回起動時に依存パッケージを自動インストールします（30〜60秒）。

Mac / Linux で使う場合

JRA-VANのデータ取得（jrvltsql）はWindows専用ですが、データベースをMac/Linuxに持ってくればこのMCPサーバーは動作します。

方法1: SQLiteファイルをコピー

Windows                          Mac / Linux
┌─────────────┐                  ┌─────────────┐
│  jrvltsql   │                  │  keiba.db   │ ← コピー
│      ↓      │   ファイル共有    │      ↓      │
│  keiba.db   │ ───────────────▶ │ MCPサーバー  │
└─────────────┘   クラウド同期    │      ↓      │
                                 │Claude Desktop│
                                 └─────────────┘

Dropbox、Google Drive、USBメモリなどでkeiba.dbをコピーするだけ。 データ更新時は再度コピーが必要です。

方法2: PostgreSQL経由（リアルタイム更新）

Windows                          Mac / Linux
┌─────────────┐                  ┌─────────────┐
│  jrvltsql   │                  │ MCPサーバー  │
│      ↓      │    ネットワーク   │      ↓      │
│ PostgreSQL  │ ◀───────────────│Claude Desktop│
└─────────────┘                  └─────────────┘

jrvltsqlはPostgreSQLへの書き込みにも対応。 Mac/LinuxからWindowsのPostgreSQLに接続すればリアルタイムで最新データを利用できます。

Mac / Linux でのセットアップ

# 1. リポジトリをクローン
git clone https://github.com/miyamamoto/jvlink-mcp-server.git
cd jvlink-mcp-server

# 2. 依存関係をインストール
pip install uv
uv sync

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"
      }
    }
  }
}
PostgreSQLを使う場合の設定 
{
  "mcpServers": {
    "jvlink": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/jvlink-mcp-server", "python", "-m", "jvlink_mcp_server.server"],
      "env": {
        "DB_TYPE": "postgresql",
        "DB_HOST": "your-windows-pc.local",
        "DB_PORT": "5432",
        "DB_NAME": "keiba",
        "DB_USER": "your_user",
        "DB_PASSWORD": "your_password"
      }
    }
  }
}

使い方のコツ

コツ説明
気軽に質問思いついたことをそのまま聞いてみてください
条件を追加「東京の」「芝の」「1600mの」など条件を絞ると詳細な分析に
比較を依頼「AとBを比較して」「年度別の推移を見せて」も得意です
深掘りする回答を見て気になったら続けて質問。会話で分析を深められます

→ もっと質問例を見たい場合は

JRA-VANデータの利用について

本ソフトウェアで分析するデータはJRA-VANから提供されるものです。

禁止事項: データの再配布、第三者への提供、データベースファイルの共有

許可される利用: 個人的な競馬分析・研究、自社内での利用

詳細は JRA-VAN利用規約 をご確認ください。

ライセンス