Tsrs MCP Server

一個基於MCP協議的TuShare數據服務，提供多種股票市場數據查詢功能

金融研究與數據 #股票數據 #市場分析 #資金流向 #概念題材 .Rust

評分 : 2.5分

下載量 : 8.4K

更新時間 : 2025-04-29

打開站點

什麼是TuShare MCP 數據服務器？

TuShare MCP 數據服務器是一個基於Rust語言構建的高效數據查詢工具，通過封裝TuShare API接口，為用戶提供豐富的股票市場數據。它支持多種查詢工具，適用於投資者、分析師以及任何需要即時市場數據的用戶。

如何使用TuShare MCP 數據服務器？

用戶可以通過簡單的命令行操作來獲取所需數據。只需設置好API Token，並按照指示執行相關命令即可快速獲得所需信息。

適用場景

適用於股票投資分析、市場趨勢研究以及日常交易決策支持等領域。

主要功能

limit_step

獲取每天連板個數晉級的股票，支持指定日期範圍和連板次數。

ths_hot

獲取同花順App熱榜數據，支持按天查詢。

kpl_list

獲取漲跌停板數據，支持指定日期範圍和標籤過濾。

kpl_concept

獲取開盤啦概念題材列表，支持按天查詢。

moneyflow_ths

獲取同花順個股資金流向數據，支持指定股票代碼和日期範圍。

優勢

高性能：基於Rust語言開發，運行速度快且穩定。

易用性：提供直觀的命令行接口和詳細的使用說明。

豐富數據源：集成TuShare API，覆蓋廣泛市場數據。

靈活性：支持多種自定義查詢選項。

侷限性

依賴外部API：需註冊TuShare賬號並獲取Token。

數據延遲：部分數據可能有一定時間延遲。

需要一定計算機基礎：適合有一定編程經驗的用戶。

如何使用

安裝與配置

下載並解壓發佈版本，設置TuShare API Token。

啟動服務器

運行服務器二進制文件以開始監聽請求。

執行查詢命令

根據需求輸入對應的查詢命令。

使用案例

案例標題：獲取連板晉級股票

查詢2023年8月1日至8月31日期間，連板次數為5次的股票。

案例標題：獲取個股資金流向

查詢2023年9月1日某隻股票的資金流向數據。

常見問題

如何獲取TuShare API Token？

服務器無法正常啟動怎麼辦？

查詢結果為空怎麼辦？

🚀 tsrs-mcp-server

這是一個基於 模型上下文協議 (MCP) 的TuShare數據服務器，它提供了一系列股票市場數據查詢接口，能幫助用戶便捷地獲取所需的股票市場數據。

🚀 快速開始

在使用本項目前，你需要進行環境配置和構建操作。首先，要設置TuShare的API token，然後進行項目的構建。

環境配置

在運行之前，需要設置TuShare的API token：

複製 .env.example 為 .env
在 .env 文件中設置你的TuShare token:

TUSHARE_TOKEN=your_token_here

構建

前提條件：安裝 Rust 和 Cargo。

cargo build --release

./target/release/tsrs-mcp-server

運行

你可以在 release 中找到對應平臺下的編譯產物, 例如 tsrs-mcp-server-<tag>-aarch64-apple-darwin.tar.gz。運行方式如下圖配置(僅展示在 chatwise 的配置):

✨ 主要特性

項目提供了以下 MCP 工具：

工具名稱	功能描述	主要參數	返回數據
limit_step	獲取每天連板個數晉級的股票	trade_date, start_date, end_date, nums	股票代碼、名稱、交易日期、連板次數
ths_hot	獲取同花順App熱榜數據	trade_date	股票信息、排名、熱度、概念等
kpl_list	獲取漲跌停板數據	tag, start_date, end_date	漲跌停詳細信息、成交數據等
kpl_concept	獲取開盤啦概念題材列表	trade_date	題材代碼、名稱、漲停數量等
kpl_concept_cons	獲取開盤啦概念題材的成分股	trade_date, ts_code	題材成分股詳細信息
limit_cpt_list	獲取每天漲停股票最多的概念板塊	trade_date, start_date, end_date	板塊代碼、名稱、連板數據等
moneyflow_ths	獲取同花順個股資金流向數據	ts_code, trade_date, start_date, end_date	資金流向詳細數據
moneyflow_cnt_ths	獲取同花順概念板塊每日資金流向	trade_date, start_date, end_date	板塊資金流向數據
stk_mins	獲取A股分鐘數據	ts_code, freq, start_date, end_date	分鐘級別的交易數據

📚 詳細文檔

項目簡介

本項目是一個用 Rust 實現的 MCP 服務器，封裝了 TuShare 的 API 接口，提供了多個股票市場數據查詢工具。項目主要使用以下技術：

Rust
模型上下文協議 (MCP)
Poem MCP 服務器
TuShare API
過程宏 (Procedural Macros)

項目結構

項目包含以下主要組件：

ts-derive: 提供用於 TuShare API 的過程宏實現
ts-model: 包含數據模型
src: 主程序實現

📄 許可證

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

🙏 鳴謝

感謝以下項目和庫, 尤其是 poem-mcpserver 對 MCP 編寫的極大便捷性支持, 沒有它, 本項目沒有如此簡便的實現方式。同時感謝 TuShare API 提供的數據接口。最後要感謝 rust, 沒有 procedural macros, 本項目的模版實現將變得異常機械化。