项目档案开源项目

liqiongyu/xueqiu_mcp 是什么？用途、安装与使用指南

liqiongyu/xueqiu_mcp：Xueqiu MCP 是一个基于雪球 API 的 MCP 服务，使 AI 助手能直接查询股票数据。本页整理它解决什么问题、适用场景、安装方式和使用方法。

115PythonStar 于 2026年1月13日2026年7月8日更新

查看 GitHub 仓库

AI 总结

Xueqiu MCP 是一个基于雪球 API 的 MCP 服务，使 AI 助手能直接查询股票数据。

中文项目介绍

Xueqiu MCP 通过封装 pysnowball 库，将雪球股票数据接口以模型上下文协议（MCP）形式暴露，让 Claude、Cursor 等支持 MCP 的 AI 助手能够实时获取 A 股、港股行情、指数、基金、北向资金等金融信息。

详细信息与使用说明

1. 项目概述

Xueqiu MCP 是一个基于雪球 API 的 MCP（模型上下文协议）服务应用。它封装了 pysnowball 库，通过标准化的 MCP 协议将股票数据查询能力提供给支持 MCP 的 AI 助手，使用户能在对话中直接获取金融数据。

2. 解决的核心问题

AI 助手（如 Claude）默认无法直接访问实时、专业的金融数据源（如雪球）。本项目通过 MCP 协议标准化集成雪球 API，使 AI 助手具备查询和分析中国股票市场数据的能力，用户无需自行编写代码或寻找替代数据源。

3. 主要应用场景

- 在 Claude Desktop 或 Cursor 等 AI 助手中直接查询 A 股、港股实时行情 - 通过对话形式分析指数收益、基金数据或北向资金流向 - 利用 AI 助手的关键词搜索功能快速查找股票代码

4. 安装与配置

1. 克隆仓库：`git clone https://github.com/liqiongyu/xueqiu_mcp.git && cd xueqiu_mcp` 2. 安装依赖：`uv venv && uv pip install -e .` 3. 配置 Token：在项目根目录创建 `.env` 文件，内容为 `XUEQIU_TOKEN="xq_a_token=xxxxx;u=xxxx"`（需替换为有效 token，获取方法参考 pysnowball 文档）。

5. 运行与使用

启动 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" }

思维导图

Xueqiu MCP

项目目标

让 AI 助手获取雪球股票数据

技术依赖

fastmcp (MCP 框架)

pysnowball (雪球 API 封装)

环境配置

需设置 XUEQIU_TOKEN 环境变量

启动方式

uv --directory <项目路径> run main.py

核心功能

股票实时行情

指数收益查询

北向资金数据

基金数据查询

关键词搜索股票

常见问题

liqiongyu/xueqiu_mcp 是做什么的？