Japan Stock Market Data MCP (TSE Screener)

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

OtherPythonv0.1.0

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.

Setup from the maintainer

This listing does not have a supported local package template. Use the maintainer’s documentation for its hosted endpoint, authentication, and client-specific setup. No install command has been inferred.

Package

https://github.com/atushi1841/japan-stock-mcp/releases/download/v0.1.0/server.mcpbother

Compatible MCP Clients

Japan Stock Market Data MCP (TSE Screener) works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More