# Changelog — 技术栈 Cursor 规则 + MySQL MCP 配置

**日期**: 2026-05-22  
**类型**: 规范 / 工具链  

## 变更摘要

1. 新增 4 条基于 Nexus 技术栈的 Cursor 规则（`.cursor/rules/`）
2. 全局安装 `@yclenove/mysql-mcp-server`，配置项目 `.cursor/mcp.json`
3. 新增 `scripts/sync_mysql_mcp_env.py` 从 `NEXUS_DATABASE_URL` 同步 `MYSQL_*`
4. 新增 `docs/project/mysql-mcp-setup.md` 配置指南

## 新增 Cursor 规则

| 文件 | 作用域 |
|------|--------|
| `nexus-tech-stack.mdc` | alwaysApply — 分层、配置、数据流 |
| `nexus-python-backend.mdc` | `server/**/*.py` |
| `nexus-frontend.mdc` | `web/app/**` |
| `nexus-security.mdc` | API/应用/DB/前端 — JWT、MCP 只读 |

## MCP

- 命令：`npx -y @yclenove/mysql-mcp-server`（Windows 经 `cmd /c`）
- 连接：项目根 `.env` 内 `MYSQL_*`（由 sync 脚本生成，默认只读）

## 涉及文件

- `.cursor/rules/nexus-*.mdc`（4 个）
- `.cursor/mcp.json`
- `scripts/sync_mysql_mcp_env.py`
- `docs/project/mysql-mcp-setup.md`
- `.env.example`（MCP 注释块）
- `docs/README.md`

## 用户待办（启用 MCP 前）

1. 确保有 `.env`（安装向导或 `copy .env.example .env`）
2. `python scripts/sync_mysql_mcp_env.py`
3. Cursor → Settings → MCP → 启用 `mysql-mcp` → Reload Window

## 验证

- [x] `npm install -g @yclenove/mysql-mcp-server@latest` 成功
- [x] `mysql-mcp-server` 可执行并读取 worktree 为 cwd
- [ ] 用户本地 `.env` + sync 后 `test_connection` 通过（需本机 MySQL）