Stock MCP

基於Model Context Protocol的智能股票數據服務，提供A股/港股/美股的即時行情、基本面分析、新聞資訊和AI驅動的深度研究報告

金融研究與數據 #股票數據 #AI分析 #多市場 #即時行情 .Python

評分 : 2.5分

下載量 : 6.5K

更新時間 : 2025-10-09

打開站點

什麼是Stock MCP Server?

Stock MCP Server是一個智能股票數據服務平臺，通過Model Context Protocol技術為AI助手和應用程序提供全球股票市場數據服務。它整合了A股、港股、美股三大市場的即時行情、歷史數據、新聞資訊和基本面分析，並內置AI驅動的深度研究功能。

如何使用Stock MCP Server?

使用Stock MCP Server非常簡單：1) 通過Docker一鍵部署服務；2) 配置必要的API密鑰；3) 通過RESTful API或MCP協議訪問股票數據；4) 集成到您的AI助手或應用程序中。整個過程只需5分鐘即可完成。

適用場景

Stock MCP Server適用於：投資分析、量化交易研究、AI助手股票查詢、金融數據可視化、投資教育、市場監控等多種場景。無論是個人投資者還是專業機構，都能從中獲得價值。

主要功能

全球市場覆蓋

一站式接入A股、港股、美股三大市場數據，支持超過200個交易所的股票信息查詢

AI智能分析

內置新聞情緒分析、深度研究報告生成、智能語義搜索等AI功能，提供數據驅動的投資建議

多數據源融合

智能聚合AKShare、Tushare、yFinance、Finnhub等多個權威數據源，確保數據準確性和完整性

高性能緩存

基於Redis的智能緩存系統，支持自動降級機制，確保服務穩定可靠，響應迅速

一鍵部署

提供完整的Docker容器化方案，5分鐘即可完成服務部署，開箱即用

完整API生態

提供RESTful API和MCP協議雙重接口，支持即時行情、歷史數據、財務報表、技術指標等全方位數據服務

優勢

🌐 全球市場一站式覆蓋，無需切換多個數據源

🤖 AI驅動的深度分析，超越傳統數據服務

🚀 開箱即用，Docker部署簡單快捷

📊 數據源豐富，準確性有保障

💾 高性能緩存，訪問速度快

🔄 持續更新維護，功能不斷完善

侷限性

⚠️ 部分高級功能需要配置額外的API密鑰

⏱️ 即時數據更新頻率受數據源限制

🌍 某些國際市場數據可能存在延遲

🔧 需要基本的服務器部署知識

📈 歷史數據深度受數據源政策限制

如何使用

環境準備

確保您的系統已安裝Docker和Docker Compose，這是運行Stock MCP Server的基礎環境要求

獲取項目代碼

從代碼倉庫克隆項目到本地，準備進行配置和部署

配置環境變量

複製環境配置文件並設置必要的API密鑰，特別是Tushare Token用於A股數據訪問

啟動服務

使用Docker Compose一鍵啟動所有服務組件，包括API服務、MCP服務和Redis緩存

驗證服務

訪問Swagger UI文檔界面，確認服務正常運行並瞭解所有可用接口

使用案例

個股深度分析

對特定股票進行全面的歷史表現分析和基本面研究，生成投資分析報告

多股對比研究

同時分析多隻相關股票的即時行情和基本面數據，進行橫向對比

市場監控

設置定時查詢特定股票組合的即時行情，監控市場變化

新聞情緒分析

基於最新新聞資訊分析市場情緒，評估對特定股票的影響

常見問題

Stock MCP Server是免費的嗎？

支持哪些股票市場？

數據更新頻率是多少？

需要什麼技術基礎才能使用？

如何獲取Tushare Token？

支持即時推送數據嗎？

數據準確性如何保證？

是否支持移動端訪問？

🚀 📈 Stock MCP Server

Stock MCP Server 是一個基於 Model Context Protocol 的智能股票數據服務平臺，能夠一站式獲取 A 股、港股、美股的即時數據，並提供 AI 驅動的深度分析，為投資者提供全面、準確、高效的股票信息服務。

🚀 快速開始

# 1. 克隆項目
git clone <your-repo-url> && cd stock-mcp

# 2. 配置環境變量（必需：TUSHARE_TOKEN）
cp .env.example .env && vim .env

# 3. 一鍵啟動
docker-compose up -d

# 4. 訪問服務
open http://localhost:9998/docs

🎯 5分鐘體驗核心功能：

# 查詢茅臺歷史價格及AI分析
curl "http://localhost:9998/stock/price?symbol=600519&start_date=2024-01-01&end_date=2025-01-01"

# 獲取蘋果即時行情
curl "http://localhost:9998/api/stock/news?symbol=AAPL"

# 查詢股票基本面數據
curl "http://localhost:9998/api/stock/fundamental?symbol=000008&curr_date=2025-06-01"

# 批量查詢多隻股票
curl -X POST "http://localhost:9998/api/stock/quotes" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["AAPL", "TSLA", "MSFT"]}'

✨ 主要特性

🌐 全球市場覆蓋 - 一鍵接入 A 股、港股、美股數據。
🤖 AI 智能分析 - 提供新聞情緒分析、深度研究報告、智能搜索等功能。
🚀 開箱即用 - 通過 Docker 一鍵部署，5 分鐘即可啟動服務。
📊 多數據源融合 - 智能聚合 AKShare、Tushare、yFinance、Finnhub 等多個數據源。
💾 高性能緩存 - 採用 Redis 加速，並具備自動降級功能，穩定可靠。

📦 安裝指南

核心配置（`.env` 文件）

# 【必填】A股數據訪問（申請地址：https://tushare.pro/）
TUSHARE_TOKEN=your_token_here

# 【可選】代理配置（訪問美股數據時推薦）
HTTP_PROXY=http://127.0.0.1:7890
HTTPS_PROXY=http://127.0.0.1:7890

# 【可選】增強功能
TAVILY_API_KEY=your_key     # AI 搜索和研究
FINNHUB_API_KEY=your_key    # 增強新聞數據
NEWS_API_KEY=your_key       # 新聞聚合

📖 完整配置說明

配置項	說明	默認值
`REDIS_HOST`	Redis 主機	`redis`（Docker）/ `localhost`
`CACHE_ENABLED`	是否啟用緩存	`true`
`CACHE_TTL`	緩存過期時間（秒）	`3600`

詳見：配置指南

💻 使用示例

基礎用法

# 查詢茅臺歷史價格及AI分析
curl "http://localhost:9998/stock/price?symbol=600519&start_date=2024-01-01&end_date=2025-01-01"

# 獲取蘋果即時行情
curl "http://localhost:9998/api/stock/news?symbol=AAPL"

高級用法

# 批量查詢多隻股票
curl -X POST "http://localhost:9998/api/stock/quotes" \
  -H "Content-Type: application/json" \
  -d '{"symbols": ["AAPL", "TSLA", "MSFT"]}'

📚 詳細文檔

📡 完整 API 文檔 - 所有接口詳細說明、參數、示例。
💡 API 使用示例 - 實際場景的代碼示例。
📖 使用指南 - 配置、部署、最佳實踐。
🔧 開發文檔 - 架構設計、二次開發。
🌐 OpenAPI 規範 - 標準 API 規範文件。
💻 Swagger UI - 交互式 API 測試（服務啟動後訪問）。

🔧 技術細節

API 接口概覽

分類	接口	端點	描述
📊 行情數據	Market Price	`GET /stock/price`	歷史價格+AI分析報告
	Stock Quote	`GET /api/stock/news`	即時行情快照
	Stock Quotes	`POST /api/stock/quotes`	批量行情查詢
💼 基本面	Fundamental	`GET /api/stock/fundamental`	財務基本面數據
📰 新聞資訊	Stock News	`GET /api/stock/news`	最新股票新聞
	News by Date	`GET /api/stock/news/date`	指定日期新聞
📅 交易日曆	Trading Days	`GET /api/calendar/trading-days`	交易日列表
	Is Trading Day	`GET /api/calendar/is-trading-day`	交易日檢查
	Trading Hours	`GET /api/calendar/trading-hours`	交易時間信息
	Exchanges	`GET /api/calendar/supported-exchanges`	支持的交易所

💡 提示: 所有接口支持 A 股、港股、美股三大市場。
📚 詳細文檔: 啟動後訪問 http://localhost:9998/docs。

數據查詢能力

✅ 即時行情 - 分鐘級價格/成交量。
✅ 歷史數據 - K 線圖、復權價格。
✅ 財務報表 - 資產負債表、現金流。
✅ 技術指標 - MACD、RSI、布林帶。
✅ 資金流向 - 主力資金、北向資金。

AI 增強

🔍 智能搜索 - Tavily 語義搜索。
📰 情緒分析 - 多源新聞聚合 + 評分。
📈 深度研究 - AI 生成研究報告。
💡 決策輔助 - 數據驅動的投資建議。
🌐 多語言支持 - 中英文自動識別。

API 接口文檔

交互式文檔

啟動服務後訪問以下地址查看完整的 Swagger UI 文檔：

Swagger UI: http://localhost:9998/docs
ReDoc: http://localhost:9998/redoc

股票數據接口

1️⃣ 市場行情分析 - Market Price

接口信息

路徑: GET /stock/price
描述: 獲取指定股票的歷史價格數據及 AI 分析報告。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`, `AAPL`
`start_date`	string	否	開始日期	`2024-07-13`
`end_date`	string	否	結束日期	`2025-07-13`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

響應示例

{
  "status": "success",
  "message": "成功獲取股票價格數據和分析報告",
  "data": "# AAPL 股票分析報告\n\n## 📊 基本信息\n- **股票名稱**: 蘋果公司\n- **股票代碼**: AAPL\n- **分析期間**: 2025-07-12 至 2025-08-12\n\n## 💰 價格表現\n- **當前價格**: $227.18\n- **期間漲跌**: $+18.80 (+9.02%)\n- **期間最高**: $230.74\n- **期間最低**: $201.27\n- **平均成交量**: 60,489,490\n\n## 📈 技術指標\n- **5日均線**: $218.35\n- **20日均線**: $212.25\n- **近期趨勢**: 上升"
}

使用示例

curl -X GET "http://localhost:9998/stock/price?symbol=AAPL&start_date=2024-07-13&end_date=2025-07-13" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

2️⃣ 基本面數據 - Stock Fundamental

接口信息

路徑: GET /api/stock/fundamental
描述: 獲取股票基本面財務數據。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000008`, `600519`
`curr_date`	string	否	查詢日期	`2025-06-01`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

使用示例

curl -X GET "http://localhost:9998/api/stock/fundamental?symbol=000008&curr_date=2025-06-01" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

3️⃣ 即時行情 - Stock Quote

接口信息

路徑: GET /api/stock/news
描述: 獲取股票即時行情快照。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`, `AAPL`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

響應示例

{
  "status": "success",
  "message": "成功獲取 AAPL 的即時行情",
  "data": {
    "ticker": "AAPL",
    "currentPrice": "256.48",
    "dailyChangePercent": "-0.0818107444777616",
    "peRatio": "38.919575",
    "marketCap": "3806263246848",
    "source": "yfinance"
  }
}

使用示例

curl -X GET "http://localhost:9998/api/stock/news?symbol=AAPL" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

4️⃣ 批量行情查詢 - Stock Quotes

接口信息

路徑: POST /api/stock/quotes
描述: 批量查詢多個股票的即時行情。

請求參數

參數名	類型	必填	說明
`symbols`	array	是	股票代碼列表
`Authorization`	string	否	認證令牌(Header)

使用示例

curl -X POST "http://localhost:9998/api/stock/quotes" \
  -H "Content-Type: application/json" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903" \
  -d '{"symbols": ["AAPL", "TSLA", "MSFT"]}'

新聞數據接口

5️⃣ 股票新聞 - Stock News

接口信息

路徑: GET /api/stock/news
描述: 獲取指定股票的最新新聞。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`, `AAPL`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

使用示例

curl -X GET "http://localhost:9998/api/stock/news?symbol=000001" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

6️⃣ 指定日期新聞 - News by Date

接口信息

路徑: GET /api/stock/news/date
描述: 獲取指定日期範圍內的股票新聞。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`
`target_date`	string	是	目標日期	`2025-09-10`
`days_before`	integer	否	向前查詢天數	`7`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

使用示例

curl -X GET "http://localhost:9998/api/stock/news/date?symbol=000001&target_date=2025-09-10&days_before=7" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

交易日曆接口

7️⃣ 交易日列表 - Trading Days

接口信息

路徑: GET /api/calendar/trading-days
描述: 獲取指定時間範圍內的交易日列表。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`
`start_date`	string	是	開始日期	`2025-01-01`
`end_date`	string	是	結束日期	`2025-09-01`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

使用示例

curl -X GET "http://localhost:9998/api/calendar/trading-days?symbol=000001&start_date=2025-01-01&end_date=2025-09-01" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

8️⃣ 交易日檢查 - Is Trading Day

接口信息

路徑: GET /api/calendar/is-trading-day
描述: 檢查指定日期是否為交易日。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`
`check_date`	string	是	檢查日期	`2025-09-30`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

使用示例

curl -X GET "http://localhost:9998/api/calendar/is-trading-day?symbol=000001&check_date=2025-09-30" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

9️⃣ 交易時間 - Trading Hours

接口信息

路徑: GET /api/calendar/trading-hours
描述: 獲取指定日期的交易時間信息。

請求參數

參數名	類型	必填	說明	示例
`symbol`	string	是	股票代碼	`000001`
`check_date`	string	是	檢查日期	`2025-09-30`
`Authorization`	string	否	認證令牌(Header)	`a7f3518b-...`

使用示例

curl -X GET "http://localhost:9998/api/calendar/trading-hours?symbol=000001&check_date=2025-09-30" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

🔟 支持的交易所 - Supported Exchanges

接口信息

路徑: GET /api/calendar/supported-exchanges
描述: 獲取系統支持的所有交易所列表。

請求參數

參數名	類型	必填	說明
`Authorization`	string	否	認證令牌(Header)

響應示例

{
  "status": "success",
  "message": "成功獲取支持的交易所列表",
  "data": {
    "total_count": 200,
    "regions": {
      "美國": ["NYSE", "NASDAQ"],
      "中國": ["XSHG", "XSHE"],
      "歐洲": ["XPAR", "XLON"],
      "亞太": ["NSE", "TSE"],
      "加拿大": ["TSX"]
    },
    "all_exchanges": ["NYSE", "NASDAQ", "XSHG", "XSHE", "..."]
  }
}

使用示例

curl -X GET "http://localhost:9998/api/calendar/supported-exchanges" \
  -H "Authorization: a7f3518b-2983-4d29-bd1d-15a13e470903"

認證說明

所有 API 接口均支持可選的 Authorization Header 進行身份驗證：

-H "Authorization: your-api-token-here"

獲取 Token: 請聯繫管理員或在配置文件中設置自定義 Token。

快速測試

使用以下命令快速測試主要接口：

# 查詢茅臺股價
curl "http://localhost:9998/stock/price?symbol=600519&start_date=2024-01-01&end_date=2025-01-01"

# 獲取蘋果即時行情
curl "http://localhost:9998/api/stock/news?symbol=AAPL"

# 檢查今天是否為交易日
curl "http://localhost:9998/api/calendar/is-trading-day?symbol=000001&check_date=$(date +%Y-%m-%d)"

# 獲取所有支持的交易所
curl "http://localhost:9998/api/calendar/supported-exchanges"

API 設計規範

本項目 API 遵循以下設計原則： ✅ RESTful 風格 - 使用標準 HTTP 方法(GET/POST)。
✅ 統一響應格式 - 所有接口返回統一的 JSON 結構。
✅ 詳細錯誤信息 - 錯誤響應包含明確的錯誤碼和描述。
✅ OpenAPI 3.0 - 完整的 API 規範文檔(查看)。
✅ 自動文檔生成 - Swagger UI + ReDoc 雙文檔支持。

🐳 Docker 部署

服務架構

端口	服務	說明
`9998`	FastAPI	RESTful API + Swagger 文檔
`9999`	MCP Server	Model Context Protocol 服務
`6379`	Redis	內部緩存（不對外暴露）

常用命令

# 啟動服務
docker-compose up -d

# 查看日誌
docker-compose logs -f stock-mcp

# 停止服務
docker-compose down

# 重啟服務
docker-compose restart

# 重新構建
docker-compose up -d --build

🛠️ 故障排查

❌ Redis 連接失敗

# 檢查配置
cat .env | grep REDIS_HOST
# 確保 Docker 環境使用: REDIS_HOST=redis

# 檢查 Redis 狀態
docker-compose ps redis

❌ yFinance 超時

# 檢查代理配置
cat .env | grep PROXY
# Docker 環境應使用: HTTP_PROXY=http://host.docker.internal:7890

❌ Tushare 權限錯誤

確保 Token 有效且已配置到 .env 文件：

grep TUSHARE_TOKEN .env

更多問題：完整故障排查指南

📄 許可證

本項目採用 MIT 許可證，詳見 LICENSE。

🙏 致謝

本項目基於以下優秀開源項目構建： MCP • FastAPI • AKShare • Tushare • yFinance • Tavily

⭐️ 如果對你有幫助，請給個 Star ⭐️

Markdownify MCP

Markdownify是一個多功能文件轉換服務，支持將PDF、圖片、音頻等多種格式及網頁內容轉換為Markdown格式。

百度地圖MCP Server是國內首個兼容MCP協議的地圖服務，提供地理編碼、路線規劃等10個標準化API接口，支持Python和Typescript快速接入，賦能智能體實現地圖相關功能。

Firecrawl MCP Server是一個集成Firecrawl網頁抓取能力的模型上下文協議服務器，提供豐富的網頁抓取、搜索和內容提取功能。

TypeScript

66.2K

5分

Sequential Thinking MCP Server

一個基於MCP協議的結構化思維服務器，通過定義思考階段幫助分解複雜問題並生成總結

一個基於Python的MCP服務器，通過Notion API提供高級待辦事項管理和內容組織功能，實現AI模型與Notion的無縫集成。

Context7 MCP是一個為AI編程助手提供即時、版本特定文檔和代碼示例的服務，通過Model Context Protocol直接集成到提示中，解決LLM使用過時信息的問題。

Magic Component Platform (MCP) 是一個AI驅動的UI組件生成工具，通過自然語言描述幫助開發者快速創建現代化UI組件，支持多種IDE集成。

JavaScript

15.5K

5分

Edgeone Pages MCP Server

EdgeOne Pages MCP是一個通過MCP協議快速部署HTML內容到EdgeOne Pages並獲取公開URL的服務

智啟未來，您的人工智慧解決方案智庫

Stock MCP

概述

工具列表

內容詳情

替代品

什麼是Stock MCP Server?

如何使用Stock MCP Server?

適用場景

主要功能

如何使用

使用案例

常見問題

相關資源

安裝

🚀 📈 Stock MCP Server

🚀 快速開始

✨ 主要特性

📦 安裝指南

核心配置（.env 文件）

💻 使用示例

基礎用法

高級用法

📚 詳細文檔

🔧 技術細節

API 接口概覽

數據查詢能力

AI 增強

API 接口文檔

交互式文檔

股票數據接口

接口信息

請求參數

響應示例

使用示例

接口信息

請求參數

使用示例

接口信息

請求參數

響應示例

使用示例

接口信息

請求參數

使用示例

新聞數據接口

接口信息

請求參數

使用示例

接口信息

請求參數

使用示例

交易日曆接口

接口信息

請求參數

使用示例

接口信息

請求參數

使用示例

接口信息

請求參數

使用示例

接口信息

請求參數

響應示例

使用示例

認證說明

快速測試

API 設計規範

🐳 Docker 部署

服務架構

常用命令

🛠️ 故障排查

📄 許可證

🙏 致謝

替代品

核心配置（`.env` 文件）