mcpField
J
Japan Stock Market Data MCP (TSE Screener)

Japan Stock Market Data MCP (TSE Screener)

Local
github.com/atushi1841Finance0Updated 4d ago
Repository

About Japan Stock Market Data MCP (TSE Screener)

Japan Stock Market Data MCP is an MCP server that provides Tokyo Stock Exchange data through the official J-Quants and JPX APIs. It is for AI agents and users screening Japanese stocks, checking quotes, valuations, financial summaries, and trading calendars.

Key features

  1. 01Daily OHLCV quotes
  2. 02Stock screening by market and sector
  3. 03Valuation metrics
  4. 04Financial summaries by period
  5. 05Trading calendar and sector codes

Use cases

  1. 01Screen stocks by market, sector, or capitalization
  2. 02Review a stock's recent price and volume
  3. 03Check valuation and financial figures
  4. 04Look up exchange holidays

MCP support

Exposes Japanese stock and market-data tools to MCP clients. It runs locally over stdio or HTTP and uses a J-Quants API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository
Packages
mcpbserver.mcpb0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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 テンプレ準備中

関連プロジェクト

  • 既存 Japan MCP 系列: japan-ec-mcp, japan-price-alert-mcp, japan-intel-mcp, japan-market-mcp, japan-jepx-mcp, jartic-japan-traffic-mcp 等

Apify Actor

関連するApifyアクターで同じデータをAPI経由で取得可能:

Actor名説明URL
japan-market-mcp中古品価格比較MCP（カメラ・時計・ブランド品・楽器・車・楽天）apify.actor
japan-market-mcp GitHub上記のオープンソース版github.com

J-Quants公式APIを使用する本リポジトリとは別に、スクレイピング型Actorsも提供。

License

MIT License.

Data & Store

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.