Metadata-Version: 2.4
Name: xueqiu-stock-mcp
Version: 0.2.1
Summary: 基于雪球数据源的 MCP 服务器，提供 A 股行情查询、K 线数据和技术指标计算
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: full
Requires-Dist: playwright>=1.40.0; extra == 'full'
Description-Content-Type: text/markdown

# 雪球 A 股 MCP 服务器

基于雪球(Xueqiu)数据源的 MCP 服务器，提供 A 股实时行情、K 线技术指标、盘口、财务数据查询。

## 安装

```bash
pip3 install xueqiu-stock-mcp
xueqiu-stock --setup
```

**第一步**（~10 秒）：安装 MCP 服务器本体，体积小，无重依赖。

**第二步**（~2 分钟）：`--setup` 自动安装 Playwright + Chromium 浏览器（约 150MB）。这是雪球 API 的必需依赖（用于绕过阿里云 WAF）。

> 如果 `xueqiu-stock` 命令找不到，用 `python3 -m xueqiu_stock --setup`

## MCP 配置

```json
{
  "mcpServers": {
    "xueqiu-stock": {
      "command": "xueqiu-stock"
    }
  }
}
```

配置文件位置：
- **Claude Desktop**: `~/.claude/claude_desktop_config.json`
- **Cursor**: 项目根目录 `/.cursor/mcp.json`
- **VS Code**: 项目根目录 `/.vscode/mcp.json`
- **QwenPaw**: `~/.qwenpaw/config.json` → `mcp.clients`

## 提供的工具

| 工具 | 功能 |
|------|------|
| `get_stock_quote` | 实时行情（价格、涨跌幅、PE/PB、市值等） |
| `get_kline_data` | K 线数据 + 技术指标（MA/MACD/RSI/BOLL/KDJ） |
| `get_minute_data` | 分时走势（逐分钟价格和成交量） |
| `get_pankou_data` | 五档盘口（买卖五档价格和数量） |
| `get_financial` | 财务报表（利润表/资产负债表/现金流量表） |

## 命令

```bash
xueqiu-stock           # 启动 MCP 服务器
xueqiu-stock --setup   # 安装依赖（Playwright + Chromium）
xueqiu-stock --check   # 检查依赖是否就绪
```

## 故障排除

**`pip3` 也没有？**
```bash
python3 -m pip install xueqiu-stock-mcp
```

**启动报错"缺少 playwright"？**
```bash
xueqiu-stock --setup
```

**`--setup` 很慢？**
Chromium 下载约 150MB，首次需要下载。如网络慢可手动下载：https://playwright.dev/python/docs/intro#installing-browsers

## PyPI

https://pypi.org/project/xueqiu-stock-mcp/
