雪球 MCP

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

项目介绍

该项目基于pysnowball封装了Snowball API，并通过MCP协议提供服务，使您能够直接在如Claude这样的AI助手中查询股票数据。

安装方法

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

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

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

配置

配置Snowball Token

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

XUEQIU_TOKEN=您的雪球token

• 快捷方式：

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

关于如何获取Snowball 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 - Snowball股票数据接口的Python版本
• fastmcp - MCP服务框架

许可证

MIT License