Metadata-Version: 2.4
Name: kai-pan-zhang-mcp-server
Version: 0.1.0
Summary: 开盘涨股票策略MCP服务 - 基于沪深300成分股的开盘涨幅选股策略
Author-email: Your Name <your.email@example.com>
License: MIT
License-File: LICENSE
Keywords: bailian,mcp,stock,strategy,trading
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: baostock>=0.8.9
Requires-Dist: matplotlib>=3.7.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# 开盘涨股票策略 MCP 服务

基于阿里云百炼平台的 MCP (Model Context Protocol) 服务，提供沪深300成分股开盘涨幅选股策略分析工具。

## 功能特性

- **获取沪深300成分股列表**: 查询当前沪深300指数的成分股信息
- **获取股票日线数据**: 下载指定股票的历史K线数据
- **运行开盘涨策略**: 执行开盘涨幅选股策略，返回交易信号和收益分析
- **生成策略报告**: 输出详细的订单信息和盈亏曲线

## 安装

### 使用 uvx (推荐)

```bash
uvx kai-pan-zhang-mcp-server
```

### 从源码安装

```bash
pip install kai-pan-zhang-mcp-server
```

## MCP 工具说明

### 1. `get_hs300_stocks`

获取沪深300成分股列表

**输入参数**: 无

**返回**: 成分股代码和名称列表

### 2. `get_stock_daily_data`

获取指定股票的日线数据

**输入参数**:
- `stock_code` (string): 股票代码，如 "sh.600000"
- `start_date` (string, 可选): 开始日期，格式 YYYY-MM-DD，默认为 "2025-01-01"

**返回**: 日线数据摘要信息

### 3. `fetch_all_stock_data`

批量获取沪深300所有成分股的日线数据并保存

**输入参数**:
- `start_date` (string, 可选): 开始日期，默认为 "2025-01-01"

**返回**: 数据保存路径和记录数

### 4. `run_strategy`

运行开盘涨策略分析

**输入参数**: 无

**返回**: 策略执行结果，包括订单数量、累计收益率等

### 5. `get_strategy_report`

获取详细的策略报告

**输入参数**: 无

**返回**: 包含订单明细和收益分析的完整报告

### 6. `send_email_report`

发送策略报告到指定邮箱

**输入参数**: 无

**环境变量要求**: 必须设置 `EMAIL_PASSWORD`

**返回**: 发送状态

## 环境变量配置

1. 登录 [阿里云百炼控制台](https://bailian.console.aliyun.com/)
2. 进入 **应用** -> **MCP管理** -> **创建MCP服务**
3. 填写以下信息:
   - **服务名称**: `kai-pan-zhang-mcp`
   - **部署方式**: 选择 **UVX**
   - **PyPI包名**: `kai-pan-zhang-mcp-server`
   - **Python版本**: `3.10`
   - **启动命令**: `uvx kai-pan-zhang-mcp-server`

## 本地开发

```bash
# 克隆项目
git clone <repository-url>
cd kai-pan-zhang-mcp-server

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# 安装依赖
pip install -e .

# 运行服务
python -m kai_pan_zhang_mcp.server
```

## 策略说明

**开盘涨策略**:
- T-1日收盘时，计算所有沪深300成分股的收益率
- 选择收益率最高的股票
- 以T-1日收盘价买入，T日开盘价卖出
- 设置手续费万分之四

## 依赖说明

- `mcp`: MCP协议实现
- `baostock`: 证券宝数据接口，获取股票行情数据
- `pandas`: 数据处理
- `numpy`: 数值计算
- `matplotlib`: 绘制盈亏曲线
- `rich`: 终端美化输出

## 许可证

MIT License

## 注意事项

1. 本服务仅供研究和学习使用，不构成投资建议
2. 股票市场有风险，投资需谨慎
3. 数据来源于 baostock，可能存在延迟或错误
