A股量化MCP Server

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

功能

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

安装

pip install a-stock-mcp

使用

在 OpenCode 中使用

在 opencode.json 中配置：

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

在 Hermes 中使用

在 config.yaml 中配置：

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

开发

# 克隆仓库
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