stock-mcp

中国A株株価・指数情報 MCP

AI エージェント向けの中国A株の株価・市場指数情報をリアルタイムで提供します。銘柄コード（sh600519、600519）または中国語名（贵州茅台）で照会でき、銘柄名の自動解決と2つのデータソースに対応しています。

• 30秒でお試しください：無料の公開 MCP エンドポイントがすでに稼働しています。URL を MCP クライアントに貼り付けるだけです（インストール不要、API キー不要）。
• またはセルフホスト：無料の公開株価エンドポイント（Tencent Finance を優先、Sina Finance をフォールバック）だけを使用する、小規模な FastMCP サーバーです。有料 API もキーも不要です。

⚡ ホスト型エンドポイントを使用する（セットアップ不要）

https://mcp.pianam.cn/stock-mcp/mcp

トランスポート：Streamable HTTP（MCP 2025-03-26 互換）。認証は不要です。

🔌 クライアントの設定

MCP クライアント（Claude Desktop、Cursor、Cline、Cherry Studio など）の mcpServers 設定に、以下を追加します。

{
  "mcpServers": {
    "stock": {
      "type": "http",
      "url": "https://mcp.pianam.cn/stock-mcp/mcp"
    }
  }
}

"type": "http" を受け付けないクライアントでは、同じ設定から "type": "http" を削除して "url" だけを指定してください。

🧰 ツール

| ツール | パラメーター | 戻り値 | |

---|---|---| | query_stock_quote(stock) | stock：銘柄コード（sh600519、SH600519、600519、000858）または中国語名（贵州茅台、宁德时代）。 | 銘柄名、コード、現在価格、前日終値、始値、高値／安値、値上がり幅・率、方向（上昇／下落／横ばい）、出来高（株数・手数）、売買代金、更新時刻、データソース。 | | query_index() | （なし） | A株の主要3指数（上海総合指数／深セン成分指数／創業板指数）：指数値、変動、始値／前日終値／高値／安値、および市場全体の動向の概要（全面高／大半が下落など）。 |

使用例

• 「貴州茅台はいまいくらですか？」→ 貴州茅台のリアルタイム株価。
• 「300750を調べて」→ CATL（寧徳時代）の株価。
• 「今日の市場全体の状況は？」→ 3つの指数と市場動向。

📡 データソース

• 優先：Tencent Finance のリアルタイム株価エンドポイント（qt.gtimg.cn）。無料の公開インターフェースで、GBK エンコードを使用し、キーは不要です。
• フォールバック：Sina Finance（hq.sinajs.cn、Referer ヘッダーを付けて送信）。優先ソースで問題が発生した場合に自動的に使用されます。
• 銘柄名からコードへの解決には Tencent の suggest API を使用し、約50銘柄の一般的な銘柄マップを同梱しているため、すぐに検索できます。
• すべてのリクエストにタイムアウトと適切な縮退処理を設定しています。API キーや登録は不要です。

データは情報提供のみを目的としており、データプロバイダーによって遅延または参考値となる場合があります。投資助言ではありません。

🐢 セルフホスト

git clone https://github.com/boy-373/stock-mcp.git
cd stock-mcp
pip install -r requirements.txt
python server.py
# listens on 127.0.0.1:8000 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py
# behind a reverse proxy, allow your public hostname:
#   MCP_ALLOWED_HOSTS="your-domain.com,your-domain.com:*" python server.py

MCP クライアントの接続先を http://127.0.0.1:8000/mcp に設定します。

uv を使用する場合：

uv venv && uv pip install -r requirements.txt
uv run python server.py

🗂️ ファイル

• stock_server.py — MCP サーバー：銘柄コード／名前の解決、Tencent と Sina の株価解析、FastMCP ツール定義。
• server.py — 単独で動作する Streamable HTTP エントリーポイント（/mcp で MCP アプリを提供）。
• requirements.txt — Python の依存関係。
• LICENSE — MIT。

---

🇨🇳 中国語の説明

A株リアルタイム株価 MCP：個別銘柄の株価照会（コード sh600519／600519 または中国語名「貴州茅台」に対応。一般的な約50銘柄のマップと Tencent の検索補完を内蔵）と、主要3指数の照会（上海総合／深セン成分／創業板。市場全体の上昇・下落傾向を含む）。

オンライン接続（無料、キー不要）：https://mcp.pianam.cn/stock-mcp/mcp

主なデータソースは Tencent Finance（qt.gtimg.cn、無料の公開インターフェース）です。失敗した場合は自動的に Sina Finance（hq.sinajs.cn）に切り替わります。すべてのリクエストにタイムアウトとわかりやすいエラー処理を設定しており、API キーは一切不要です。データは参考情報であり、投資助言ではありません。

📄 ライセンス

MIT © 2026 boy-373（劉扶陽）