Snowball MCP (雪球 MCP)

基于雪球API的MCP服务，让您通过Claude或其他AI助手轻松获取股票数据。

项目简介

本项目基于pysnowball封装了雪球API，并通过MCP协议提供服务，使您能够在Claude等AI助手中直接查询股票数据。

安装方法

方式一：在线安装（推荐）✨

无需克隆仓库，直接使用 uvx 运行：

# 设置环境变量
export XUEQIU_TOKEN="xq_a_token=xxxxx;u=xxxx"

# 直接运行
uvx snowball-mcp

方式二：Claude Desktop / Cursor / MCPHub 配置

在 MCP 客户端配置文件中添加：

{
  "mcpServers": {
    "snowball-mcp": {
      "command": "uvx",
      "args": ["snowball-mcp"],
      "env": {
        "XUEQIU_TOKEN": "xq_a_token=xxxxx;u=xxxx"
      }
    }
  }
}

方式三：本地开发安装

# 克隆仓库
git clone https://github.com/xunzhimeng/xueqiu_mcp.git
cd xueqiu_mcp

# 使用uv安装依赖
uv pip install -e .

# 创建 .env 文件配置 token
echo 'XUEQIU_TOKEN="xq_a_token=xxxxx;u=xxxx"' > .env

# 运行
snowball-mcp

配置雪球Token

关于如何获取雪球token，请参考pysnowball文档。

多 Token 配置（可选）

为了分散请求压力、减少限流错误，支持配置多个 Token：

# 方式一：逗号分隔
XUEQIU_TOKEN="token1,token2,token3"

# 方式二：多个环境变量
XUEQIU_TOKEN_1="token1"
XUEQIU_TOKEN_2="token2"
XUEQIU_TOKEN_3="token3"

多 Token 会自动轮换使用，当某个 Token 连续失败时会临时禁用并切换到下一个。

功能特性

• 获取股票实时行情
• 获取K线数据（支持日/周/月/季/年线和分钟级数据）
• 查询指数收益
• 获取深港通/沪港通北向数据
• 基金相关数据查询
• 关键词搜索股票代码
• 财务报表数据（利润表、资产负债表、现金流量表等）
• 资金流向数据
• 融资融券数据
• 大宗交易数据
• 机构评级和持仓数据

无需登录的功能

以下功能无需配置 Token 即可使用：

• suggest_stock - 股票搜索
• quotec - 基础行情
• pankou - 盘口数据

展示图

致谢

本项目 fork 自 liqiongyu/xueqiu_mcp，在此基础上进行了改进和优化。

• liqiongyu/xueqiu_mcp - 原始项目
• pysnowball - 雪球股票数据接口的Python版本
• fastmcp - MCP服务框架

许可证

MIT License