🚀 雪球 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