AKShare

io.github.hangeaiagent由 GitHub 帳號 hangeaiagent 發布v0.1.1更新於 Oct 24, 2026

Let a model explore AKShare's 1000+ China market data functions on its own — search, inspect, call

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

在本機執行的 MCP 伺服器，讓助理依需求搜尋、檢視並呼叫 AKShare 的一千多個中國市場資料函式。

可以做什麼
依關鍵字搜尋 AKShare 函式庫，找出能取得某類資料的函式，例如龍虎榜、北向資金持股明細。檢視指定函式的簽章，了解它需要哪些參數。以參數呼叫選定的函式並取得回傳資料，欄名維持原始中文。回傳列數受可設定的上限限制，被截斷時會在結果中明確說明。
適用情境
需要從 AKShare 取得中國市場、總體經濟、期貨、基金或公司治理資料，又不想事先列舉所有介面時適用。最好部署在中國大陸境內的機器上，因為多數上游介面位於境內。
執行需求
以本機程序執行，可用 uvx 從 PyPI 套件安裝，也可建置並執行 Docker 映像（約 1.5G，建置需數分鐘）。選用環境變數 AKSHARE_MCP_HOST、AKSHARE_MCP_PORT 與 AKSHARE_MAX_ROWS（預設 200）。需要能連線上游資料網站的網路，最好在境內或設定代理。不需驗證或 API 金鑰。
安裝前請注意
此服務沒有驗證機制，且會向第三方網站發出請求，因此不要暴露到公網；請綁定內網，或在前方加一層帶驗證的反向代理。呼叫工具僅限 akshare 模組中公開的可呼叫屬性，但仍會發出真實的外部請求。AKSHARE_MAX_ROWS 不宜設得過大，以免大量結果排擠有用的上下文。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AKShare，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

AKShare MCP

把 AKShare 变成一个你自己跑的能力,接进 Hunter。

为什么不是「数据源」

数据源的模型是一条记录 = 一个 (市场, 数据类型, 接口地址)。

AKShare 有一千多个函数 —— 龙虎榜、十大股东、券商研报、公司治理、 南向资金、宏观、期货、基金……按数据源建模就得枚举一千多条,做不到。

Hunter 原来只从里面挑了 6 条进目录,而那 6 条是我们用得上的,不是你 用得上的。你想查「北向资金持股明细」而我们没挑,你就没辙。

改成能力之后,模型拿到三个工具,自己去找、自己去调:

akshare_search("龙虎榜")                    → 有哪些函数能查这个?akshare_signature("stock_lhb_detail_em")   → 它要什么参数?akshare_call("stock_lhb_detail_em", {...}) → 调它

不需要我们提前枚举。

为什么要你自己跑

AKShare 是 Python 库不是 HTTP 服务,没法在表单里填一个 URL。而且它多数 接口的上游在国内,从境外容器直连经常打不通。

跑起来

bash
cd tools/akshare-mcpdocker build -t akshare-mcp .docker run -d -p 8931:8931 --name akshare-mcp akshare-mcp

镜像大约 1.5G(AKShare 自己拖着 pandas/lxml/beautifulsoup4 一大串), 首次构建要几分钟。

验证:

bash
curl -N http://localhost:8931/sse# 有 SSE 流出来就是起来了(它不会自己结束,Ctrl-C 退出)

接进 Hunter

能力 → 接入一个工具 → 填:

字段值
传输方式sse
地址http://你的地址:8931/sse
需要 key不勾

Hunter 跑在 Docker 里的话,localhost 指的是 Hunter 自己的容器 —— 要填宿主机地址(Linux 上是 172.17.0.1,Docker Desktop 上是 host.docker.internal),或者把两个服务放进同一个 compose 网络。

⚠️ **不要填 Hunter 官方的任何地址。**这个服务存在的意义就是让你不依赖我们。

环境变量

变量默认说明
AKSHARE_MCP_HOST0.0.0.0监听地址
AKSHARE_MCP_PORT8931端口
AKSHARE_MAX_ROWS200单次返回最大行数

AKSHARE_MAX_ROWS 不要调太大:AKShare 有些接口一次几万行,原样塞进模型 上下文会把真正有用的东西挤掉。被截断时返回里会明确说,不会假装那就是全部。

安全

akshare_call 只能调 akshare 模块里公开的、可调用的属性:

  • 名字带 _ 前缀的拒绝
  • 带 . 的(想访问子模块)拒绝
  • 不存在或不可调用的拒绝
  • 不做 eval / exec / 动态 import

它不是通用代码执行入口。

**但仍然不要暴露到公网。**这个服务没有鉴权,而 AKShare 会向第三方站点发 请求 —— 公网上任何人都能借你的机器发请求。绑内网,或者加一层带鉴权的反代。

常见问题

调用超时 / 连接被拒 多数 AKShare 接口的上游在国内。如果这台机器在境外,大部分接口都会失败 —— 把它跑在国内的机器上,或者给容器配代理。

函数名找不到 AKShare 的命名多是英文缩写,硬猜会一直失败:龙虎榜是 stock_lhb_detail_em 不是 stock_dragon_tiger。先 akshare_search 再 akshare_call。

返回的列名是中文 AKShare 的原样返回,我们不改列名 —— 改了之后你对着它的文档会对不上。

來源：tools/akshare-mcp/README.md，提交 4af6d96

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分