内容
# Enterprise Platform MCP
本目录用于开发“公司数字化平台日报填写 MCP 工具”。
## 已安装内容
- Python 虚拟环境：`.venv`
- Playwright：用于浏览器自动化、点击、输入、截图
- FastMCP / MCP：用于把能力暴露给 AI Agent
- python-dotenv：用于读取账号、密码等本地环境变量
- PyYAML：用于读取两套固定日报模板配置
## 后续建议目录
- `src/`：放 MCP 服务和自动化脚本
- `config/`：放平台网址、日报模板、字段规则
- `screenshots/`：保存填写确认截图和错误截图
- `logs/`：保存操作日志
## 启动虚拟环境
```powershell
& ".\.venv\Scripts\Activate.ps1"
```
## 检查依赖
```powershell
python -m pip list
python -m playwright --version
```
## 本地账号配置
登录地址已经内置，通常不需要配置。
每台设备只需要复制 `.env.example` 为 `.env`，然后填写自己的：
```text
PLATFORM_USERNAME=你的工号
PLATFORM_PASSWORD=你的密码
```
`.env` 已被 `.gitignore` 忽略，不要把它发给别人。
## MCP 服务
MCP 服务入口：
```powershell
& ".\.venv\Scripts\python.exe" ".\src\mcp_server.py"
```
可用工具：
- `fill_daily_report_draft`：填写日报草稿，不提交，返回确认截图路径。
- `submit_daily_report`：用户确认后提交当前草稿，不返回提交截图。
- `cancel_daily_report`：用户不确认时关闭浏览器会话。
示例 MCP 配置见 `mcp.json`。
