Back to Browse

Japan Stock MCP Server

FinanceUse Caution4.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

Japan TSE stock screener, quotes, valuation, financials via J-Quants API. Free, no TOS risk.

About

Japan TSE stock screener, quotes, valuation, financials via J-Quants API. Free, no TOS risk.

Security Report

4.6
Use Caution4.6High Risk

The server is a legitimate J-Quants TSE market-data client. It requires a JQUANTS_API_KEY from the environment, sends it only to api.jquants.com, and has no exfiltration, shell execution, or hardcoded secrets. The main issues are code-quality and input-handling weaknesses: user-supplied codes and dates are concatenated into request URLs without encoding, the calendar month rollover is broken for December, and there are broad exception handlers, with no finding severe enough to lower the score below 7.0. Supply chain analysis found 7 known vulnerabilities in dependencies (1 critical, 4 high severity).

6 files analyzed · 12 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

JQUANTS_API_KEYRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-atushi1841-japan-stock-mcp": {
      "env": {
        "JQUANTS_API_KEY": "your-jquants-api-key-here"
      },
      "args": [
        "japan-stock-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Japan Stock Market Data MCP(東証株価・市場データ・日本株 screener)

TSE 株式・市場データ MCP サーバー — 東京証券取引所の株価・市場データを AI エージェントに提供。

公式 API(J-Quants / JPX)を使用するため TOS リスクなし・無料枠あり。

Tools(MCP ツール一覧)

ツール名機能
get_quote(code, days)指定銘柄の最新日足 OHLCV(高値・安値・出来高含む)
screener(market, sector, min_market_cap, ...)市場・業種・時価総額・価格・値幅で株をスクリーニング
get_valuation(code)時価総額・PER・PBR・配当利回り
get_financial_summary(code, period)売上高・営業利益・純利益(四半期累計)
get_calendar(year, month)取引カレンダー(休日リスト)
sector_list()33業種 / 17業種 分類コードマッピング

動作要件

  • Python >= 3.10、fastmcp / mcp
  • 無料枠: J-Quants 無料プラン(12週間データラグ)
  • 認証: JQUANTS_API_KEY 環境変数(https://jpx-jquants.com で無料登録)
  • 完全ローカル実行(stdio / HTTP 両対応)

Quickstart

# 1. クローン
git clone https://github.com/atushi1841/japan-stock-mcp.git
cd japan-stock-mcp

# 2. 依存
pip install fastmcp

# 3. stdio mode で起動(Claude Desktop 等から接続)
export JQUANTS_API_KEY="your-free-key"
python server.py

# 4. HTTP mode で起動
python server.py --http --port 8000

動作確認

python server.py --http --port 8000 &
sleep 2
curl -s -X POST http://localhost:8000/mcp/tools/list \
  -H "Content-Type: application/json" \
  -d '{}' | jq '.tools[].name'

MCP 公開レジストリ登録状況

レジストリ状態備考
MCP 公式レジストリ✅ 登録済みio.github.atushi1841/japan-stock-mcp
Smithery📝 未登録MCPB バンドル作成済(v0.1.0)— 公開はユーザー手動操作待ち
mcp.so📝 未登録YAML テンプレは Kensho 側に mcp_so_configs/ 予定

関連プロジェクト

  • Kensho: https://github.com/atushi1841/kensho
  • 既存 Japan MCP 系列: japan-ec-mcp, japan-price-alert-mcp, japan-intel-mcp, japan-market-mcp, japan-jepx-mcp, jartic-japan-traffic-mcp 等

License

MIT License. See Kensho project for the full stack.

Reviews

No reviews yet

Be the first to review this server!