J-Quants Free MCP server

by cygkichi

320 downloads
Not rated
GitHub

About

A Model Context Protocol server that provides access to the free version of the J-Quants API, enabling retrieval of Japanese stock data and financial statements.

Details

Author
cygkichi
Downloads
320
Categories
Other, API

- search_company: Search listed companies by Japanese text.
- get_daily_quotes: Fetch daily stock prices by company code.
- get_financial_statements: Retrieve financial statements by company code.
- No paid subscription required for the underlying API.

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name J-Quants Free MCP server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Register at J-Quants API to obtain an ID token, then set the JQUANTS_ID_TOKEN environment variable. Configure your MCP client (e.g., Claude Desktop) with the server path and that environment variable.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "j-quants free mcp server": {
            "e-stat": {
                "command": "uv",
                "args": [
                    "--directory",
                    "/path/to/jquants-free-mcp-server",
                    "run",
                    "server.py"
                ],
                "env": {
                    "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
                }
            }
        }
    }
}

McpServers

{
    "e-stat": {
        "command": "uv",
        "args": [
            "--directory",
            "/path/to/jquants-free-mcp-server",
            "run",
            "server.py"
        ],
        "env": {
            "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
        }
    }
}

J-Quants Free MCP server

Model Context Protocol (MCP) サーバーで、無償版J-Quants APIのにアクセスするための機能を提供します。

ツール

このサーバーは以下のツールを提供しています:

- search_company : 日本語のテキストから、上場銘柄を検索する
- get_daily_quotes : 銘柄コードから、日次の株価を取得する
- get_financial_statements : 銘柄コードから、財務諸表を取得する

使い方

このサーバーを使用するには、J-Quants APIへの登録が必要です。以下の手順で取得できます: - J-Quants APIに登録 - IDトークンを取得しして、JQUANTS_ID_TOKEN環境変数に設定

Claude Desktop

- On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "e-stat": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/jquants-free-mcp-server",
                "run",
                "server.py"
            ],
            "env": {
                "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
            }
        }
    }
}
{
    "mcpServers": {
        "e-stat": {
            "command": "uvx",
            "args": [
                "jquants-free-mcp-server"
            ],
            "env": {
                "JQUANTS_ID_TOKEN": "YOUR_JQUANTS_ID_TOKEN"
            }
        }
    }
}

使用例

例えばClaudeに以下のような質問ができます:
- "コメダとルノアールの自己資本比率を比較して"
- "UUUMとカバーとANYCOLORの財務表を取得して、バランスシートを図にしてください。"
sample

ライセンス

このプロジェクトはMITライセンスの下で提供されています
- 詳細はLICENSEファイルを参照してください。

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.