MCP Stock Analyst

MCP Stock Analyst 📈

English | 简体中文 | 繁體中文 | 🌍 Local Guides

---

English · MCP Stock Analyst

Current version: 0.3.1 · 13 markets · pay-per-call, no subscription

Real-time quotes, fuzzy symbol search and historical K-lines across 13 markets — one free-key endpoint.

A Model Context Protocol (MCP) server delivering stock market data across 13 markets — China A-shares, Hong Kong, US, Taiwan, Japan, India, Canada, South Korea, UK, France, Singapore, Germany and Malaysia — live quotes, smart symbol search and historical K-lines.

• Zero-cost data: powered by free public market-data APIs (Tencent for A-share/HK/US, Yahoo Finance for Taiwan plus Japan / India / Canada / South Korea / UK / France / Singapore / Germany / Malaysia), no API key, no quota
• 3 practical tools: real-time quotes (batch up to 10), fuzzy search (Chinese name / pinyin / ticker code), historical candlesticks
• Dual transport: stdio (local desktop clients) + Streamable HTTP (remote hosting on Apify Standby)
• Live on Apify Store: https://apify.com/neeenja/mcp-stock-analyst — pay-per-call, no subscription
• Project page: https://panstories.github.io/mcp-stock-analyst — hosted GitHub Pages overview
• Sartbot Featured — listed in the Sartbot MCP directory

Tools

• `get_quote` — Real-time quote for one or many symbols (all 13 markets, up to 10 per call). Example: 600519,00700,AAPL,2330.TW,7203.T,RELIANCE.NS,005930.KS,HSBA.L,MC.PA,SAP.DE,RY.TO,D05.SI,1295.KL
• `search_stock` — Fuzzy lookup by Chinese name, pinyin initials, partial code or English name. Example: 茅台 / GZMT / NVIDIA / 台积电 / TSMC
• `get_kline` — Historical candlesticks (day / week / month, 20–640 bars). Example: 600519 or 2330.TW, period=day

All three tools work across every supported market — no separate tool per exchange.

Supported markets

Global stock codes (Yahoo Finance)

Everything outside mainland China / Hong Kong / US — Taiwan plus Japan, India, Canada, South Korea, UK, France, Singapore, Germany and Malaysia — is served by Yahoo Finance (free, no key). Use the exchange suffix shown above:

• 7203.T — Tokyo (explicit)
• RELIANCE.NS / TCS.NS — NSE India (.BO = BSE)
• RY.TO / TD.TO — Toronto (.V = TSX Venture)
• 005930.KS — Korea KOSPI (.KQ = KOSDAQ)
• HSBA.L — London
• MC.PA — Paris (Euronext)
• D05.SI — Singapore
• SAP.DE — Xetra Germany (.F = Frankfurt)
• 1295.KL — Malaysia
• ^TWII, ^N225, ^FTSE, ^NSEI, ^GDAXI … — market indices (any Yahoo index symbol works)

Connect (recommended: hosted endpoint)

Use the hosted MCP endpoint with any MCP client via mcp-remote:

{

"mcpServers": { "stock-analyst": { "command": "npx", "args": [ "-y", "mcp-remote", "https://neeenja--mcp-stock-analyst.apify.actor/mcp", "--header", "Authorization: Bearer ${APIFY_TOKEN}" ], "env": { "APIFY_TOKEN": " " } } } }

Get your token from Apify Console → Settings → API & Integrations.

Or run locally (stdio)

git clone https://github.com/PanStories/mcp-stock-analyst

cd mcp-stock-analyst npm install && npm run build

{

"mcpServers": { "stock-analyst": { "command": "node", "args": ["C:\\path\\to\\mcp-stock-analyst\\build\\index.js"] } } }

Debug locally

npx @modelcontextprotocol/inspector node build/index.js   # interactive inspector

node e2e-test.mjs # stdio protocol end-to-end test node http-e2e-test.mjs # local HTTP end-to-end test

Pricing (pay-per-event)

No subscription, no monthly fee — you pay per tool call:

Always free: the MCP handshake (initialize) and tools/list. Discovery costs nothing.

Every Apify account includes $5 of free platform credit monthly (~250 quote calls), so light users effectively pay nothing.

HTTP endpoints (remote mode)

Deploying your own instance

npm install -g apify-cli

apify login cd mcp-stock-analyst apify push # builds the Docker image on Apify's infrastructure

The Actor definition (.actor/actor.json) already enables Standby mode with MCP path /mcp. Your endpoint will be https://neeenja--mcp-stock-analyst.apify.actor/mcp (verify in Console → Endpoints, or read data.standbyUrl from GET https://api.apify.com/v2/acts/ ?token= ).

Tech stack

• Node.js ≥ 18, TypeScript, official @modelcontextprotocol/sdk
• Data source: Tencent public market APIs (A-share/HK/US, free, no key) + Yahoo Finance chart API (Taiwan + Japan/India/Canada/Korea/UK/France/Singapore/Germany/Malaysia, free, no key)
• Multi-stage Docker build (node:20-alpine)

Roadmap

• Pay-per-event billing
• Taiwan market support (TWSE / TPEx / TAIEX via Yahoo Finance)
• Global markets: Japan, India, Canada, South Korea, UK, France, Singapore, Germany, Malaysia (via Yahoo Finance)
• Money flow / dragon-tiger list data
• Financial report summaries
• API-key auth layer (self-hosting)

License

MIT

Privacy

Read-only and stateless — no accounts, no cookies, no trackers, and no personal data collected. See PRIVACY.md.

---

简体中文 · MCP Stock Analyst

当前版本：0.3.1 · 13 个市场 · 按次付费，无订阅

13 个市场的实时报价、智能检索与历史 K 线，一个免费无需 API key 的端点。

一个覆盖 13 个市场 的 MCP (Model Context Protocol) 服务器——A股/港股/美股/台股/日本/印度/加拿大/韩国/英国/法国/新加坡/德国/马来西亚——实时报价、智能搜索、历史K线。

• 零成本数据源：A股/港股/美股用腾讯免费公开行情接口，台股及日本/印度/加拿大/韩国/英国/法国/新加坡/德国/马来西亚走 Yahoo Finance，均无需 API key，无配额限制
• 三个实用工具：实时报价（单次最多 10 个标的）、智能搜索（中文名/拼音/代码）、历史K线
• 双传输模式：stdio（本地桌面客户端）+ Streamable HTTP（Apify Standby 远程托管）
• 已上架 Apify Store：https://apify.com/neeenja/mcp-stock-analyst —— 按次付费，无订阅
• 项目主页：https://panstories.github.io/mcp-stock-analyst —— GitHub Pages 概览页
• Sartbot 精选 —— 收录于 Sartbot MCP 目录

工具列表

• `get_quote` —— 实时报价，支持批量（13 个市场通用，单次最多 10 个）。示例：600519,00700,AAPL,2330.TW,7203.T,RELIANCE.NS,005930.KS,HSBA.L,MC.PA,SAP.DE,RY.TO,D05.SI,1295.KL
• `search_stock` —— 智能搜索：中文名/拼音首字母/部分代码/英文名。示例：茅台 / GZMT / NVIDIA / 台积电 / TSMC
• `get_kline` —— 历史K线（日/周/月，20–640 根）。示例：600519 或 2330.TW，period=day

三个工具在 13 个市场通用，不需要按交易所分别调用。

支持的市场

全球股票代码格式（Yahoo Finance）

除 A股/港股/美股外的所有市场——台湾以及日本、印度、加拿大、韩国、英国、法国、新加坡、德国、马来西亚——均由 Yahoo Finance 提供（免费、无 key）。请使用上表对应的交易所后缀：

• 7203.T —— 东京（显式指定）
• RELIANCE.NS / TCS.NS —— 印度 NSE（.BO = BSE）
• RY.TO / TD.TO —— 多伦多（.V = TSX Venture）
• 005930.KS —— 韩国 KOSPI（.KQ = KOSDAQ）
• HSBA.L —— 伦敦
• MC.PA —— 巴黎（泛欧交易所）
• D05.SI —— 新加坡
• SAP.DE —— 德国 Xetra（.F = 法兰克福）
• 1295.KL —— 马来西亚
• ^TWII、^N225、^FTSE、^NSEI、^GDAXI … —— 市场指数（任意 Yahoo 指数符号均可）

接入方式（推荐：云端端点）

任意 MCP 客户端通过 mcp-remote 连接云端端点：

{

"mcpServers": { "stock-analyst": { "command": "npx", "args": [ "-y", "mcp-remote", "https://neeenja--mcp-stock-analyst.apify.actor/mcp", "--header", "Authorization: Bearer ${APIFY_TOKEN}" ], "env": { "APIFY_TOKEN": "<你的-Apify-token>" } } } }

token 在 Apify Console → Settings → API & Integrations 获取。

或本地运行（stdio 模式）

git clone https://github.com/PanStories/mcp-stock-analyst

cd mcp-stock-analyst npm install && npm run build

{

"mcpServers": { "stock-analyst": { "command": "node", "args": ["C:\\path\\to\\mcp-stock-analyst\\build\\index.js"] } } }

本地调试

npx @modelcontextprotocol/inspector node build/index.js   # 交互式调试界面

node e2e-test.mjs # stdio 协议端到端测试 node http-e2e-test.mjs # 本地 HTTP 端到端测试

计费（按事件付费）

无订阅、无月费，按工具调用次数收费：

永远免费： MCP 握手（initialize）和 tools/list——发现类请求不计费。

每个 Apify 账号每月自带 $5 平台免费额度（按 $0.02/次约 250 次报价调用），轻度用户实际等于免费用。

HTTP 端点（远程模式）

部署你自己的实例

npm install -g apify-cli

apify login cd mcp-stock-analyst apify push # 在 Apify 平台侧构建 Docker 镜像

Actor 定义（.actor/actor.json）已启用 Standby 模式，MCP 路径 /mcp。端点形如 https://neeenja--mcp-stock-analyst.apify.actor/mcp（以 Console → Endpoints 页为准，或通过 GET https://api.apify.com/v2/acts/ ?token= 返回的 data.standbyUrl 字段获取准确地址）。

技术栈

• Node.js ≥ 18、TypeScript、官方 @modelcontextprotocol/sdk
• 数据源：腾讯公开行情接口（A股/港股/美股，免费无 key）+ Yahoo Finance chart 接口（台湾 + 日本/印度/加拿大/韩国/英国/法国/新加坡/德国/马来西亚，免费无 key）
• 多阶段 Docker 构建（node:20-alpine）

路线图

• 按事件计费
• 台湾市场支持（TWSE / TPEx / 加权指数，Yahoo Finance 数据源）
• 全球市场：日本、印度、加拿大、韩国、英国、法国、新加坡、德国、马来西亚（Yahoo Finance 数据源）
• 资金流向 / 龙虎榜
• 财报摘要
• 自定义 API key 鉴权层（自托管时用）

许可证

MIT

---

繁體中文 · MCP Stock Analyst

目前版本：0.3.1 · 13 個市場 · 按次計費，無訂閱

13 個市場的即時報價、智慧檢索與歷史 K 線，一個免費無需 API key 的端點。

一個覆蓋 13 個市場 的 MCP (Model Context Protocol) 伺服器——A股/港股/美股/台股/日本/印度/加拿大/韓國/英國/法國/新加坡/德國/馬來西亞——即時報價、智慧搜尋、歷史K線。

• 零成本資料源：A股/港股/美股使用騰訊免費公開行情介面，台股及日本/印度/加拿大/韓國/英國/法國/新加坡/德國/馬來西亞走 Yahoo Finance，皆無需 API key，無配額限制
• 三個實用工具：即時報價（單次最多 10 個標的）、智慧搜尋（中文名稱/拼音/代碼）、歷史K線
• 雙傳輸模式：stdio（本機桌面用戶端）+ Streamable HTTP（Apify Standby 遠端託管）
• 已上架 Apify Store：https://apify.com/neeenja/mcp-stock-analyst —— 按次計費，無訂閱
• 專案首頁：https://panstories.github.io/mcp-stock-analyst —— GitHub Pages 概覽頁
• Sartbot 精選 —— 收錄於 Sartbot MCP 目錄

工具列表

• `get_quote` —— 即時報價，支援批量（13 個市場通用，單次最多 10 個）。範例：600519,00700,AAPL,2330.TW,7203.T,RELIANCE.NS,005930.KS,HSBA.L,MC.PA,SAP.DE,RY.TO,D05.SI,1295.KL
• `search_stock` —— 智慧搜尋：中文名稱/拼音首字母/部分代碼/英文名稱。範例：茅台