雪球 MCP 服务

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

项目简介

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

安装方法

本项目使用 uv 进行依赖管理。请按照以下步骤进行安装：

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

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

配置

配置雪球 Token

1. 在项目根目录创建 .env 文件
2. 添加以下内容：

XUEQIU_TOKEN=您的雪球 token

• 快捷方式：

echo 'XUEQIU_TOKEN="xq_a_token=xxxxx;u=xxxx"' > .env

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

运行服务

使用以下命令启动 MCP 服务：

uv --directory /path/to/xueqiu_mcp run main.py

或者，如果您已经配置了 Claude Desktop：

"xueqiu-mcp": {
  "args": [
    "--directory",
    "/path/to/xueqiu_mcp",
    "run",
    "main.py"
  ],
  "command": "uv"
}

功能特性

• 获取股票实时行情
• 查询指数收益
• 获取深港通/沪港通北向数据
• 基金相关数据查询
• 关键词搜索股票代码

展示图

致谢

• pysnowball - 雪球股票数据接口的 Python 版本
• fastmcp - MCP 服务框架

许可证

MIT License