Xueqiu MCP

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