Metadata-Version: 2.4
Name: a-stock-mcp
Version: 0.1.1
Summary: A股数据 MCP Server — 实时行情、资金流向、龙虎榜、融资融券
Author: a-stock-mcp
License-Expression: MIT
Keywords: mcp,a-stock,akshare,quant,financial
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: akshare>=1.14.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.8.0; extra == "dev"
Requires-Dist: mypy>=1.11; extra == "dev"
Dynamic: license-file

# A股量化MCP Server

基于 FastMCP + akshare 的 A 股金融数据 MCP 服务器，提供选股筛选、北向资金追踪、龙虎榜分析和融资融券查询。

## 功能

| 工具 | 说明 |
|------|------|
| `a_stock_screener` | A股多条件选股：行业/PE/涨跌幅/涨停跌停筛选 |
| `scan_limit_up_stocks` | 扫描今日涨停股列表 |
| `scan_limit_down_stocks` | 扫描今日跌停股列表 |
| `north_flow_tracker` | 北向资金净流入趋势 + 今日汇总 |
| `dragon_tiger_analyzer` | 龙虎榜上榜个股明细（按日期/原因/净买额） |
| `margin_analysis` | 融资融券：市场汇总或单只个股两融余额 |
| `sector_analyzer` | 行业板块涨跌幅排序 |
| `sector_flow_tracker` | 板块历史走势追踪 |
| `technical_indicator` | MACD/KDJ/RSI技术指标分析 |
| `ipo_analyzer` | 新股申购信息查询 |
| `limit_stats` | 涨跌停统计汇总 |

> 所有数据来自 akshare（东方财富/新浪财经公开接口），仅供参考，不构成投资建议。

## 安装

```bash
pip install a-stock-mcp
```

## 使用

### 在 OpenCode 中使用

在 `opencode.json` 中配置：

```json
{
  "mcpServers": {
    "a-stock-mcp": {
      "command": "python",
      "args": ["-m", "src.server"]
    }
  }
}
```

### 在 Hermes 中使用

在 `config.yaml` 中配置：

```yaml
mcp_servers:
  a-stock-mcp:
    command: python
    args:
      - -m
      - src.server
    cwd: /path/to/a-stock-mcp
    enabled: true
```

## 开发

```bash
# 克隆仓库
git clone https://github.com/RedSamerai/a-stock-mcp.git
cd a-stock-mcp

# 安装依赖
pip install -e ".[dev]"

# 运行测试
pytest tests/ -v
```

## 项目结构

```
a-stock-mcp/
├── src/
│   ├── server.py          # MCP服务器入口
│   ├── data/
│   │   └── akshare_client.py  # 数据接口封装
│   └── tools/
│       ├── screener.py     # 选股工具
│       ├── north_flow.py   # 北向资金
│       ├── dragon_tiger.py # 龙虎榜
│       ├── margin.py       # 融资融券
│       ├── sector.py       # 板块分析
│       ├── technical.py    # 技术指标
│       ├── ipo.py          # 新股信息
│       └── stats.py        # 涨跌统计
├── tests/                  # 单元测试
└── pyproject.toml          # 项目配置
```

## License

MIT License
