quanters-akshare-mcp

纯 Node.js AKShare MCP Server：无需 Python、无需 pip，解决 macOS Homebrew PEP 668 安装失败问题。

覆盖 A 股、ETF、期货、大宗商品、指数、黄金；内置 1050+ 接口注册表与常用数据直连。

Cursor MCP 配置

公共 npm：

{
  "mcpServers": {
    "quanters-akshare-data": {
      "command": "npx",
      "args": ["-y", "--registry", "https://registry.npmjs.org", "quanters-akshare-mcp"],
      "env": {
        "QUANTERS_USE_AKTOOLS": "0",
        "AKSHARE_MAX_ROWS": "500"
      }
    }
  }
}

阿里内网 anpm：

"args": ["-y", "@ali/quanters-akshare-mcp"]

本地开发

npm start
# 或
npx -y .

Inspector 调试

npx @modelcontextprotocol/inspector --config .cursor/mcp.json --server quanters-akshare-data

架构

bin/quanters-akshare-mcp.js   → 入口
mcp-node/server.js            → MCP SDK (stdio)
mcp-node/lib/                 → 数据源 HTTP 直连（东财/新浪/上金所/腾讯 fallback）
mcp-node/data/api-registry.json → 1050+ 接口元数据

环境变量

| 变量 | 说明 | |------|------| | QUANTERS_USE_AKTOOLS | 1 时对未内置接口走 AKTools HTTP | | AKTOOLS_BASE_URL | AKTools 地址，默认 http://127.0.0.1:8080 | | AKSHARE_MAX_ROWS | DataFrame 最大返回行数，默认 500 |

发布

npm run publish:public   # npmjs: quanters-akshare-mcp
npm run publish:anpm     # anpm: @ali/quanters-akshare-mcp

Python 版（可选）

仓库内 mcp_server/ 仍保留 Python 实现，供本地开发/回测 Agent 使用；npm 包 0.2.0+ 默认纯 Node。