Nexus/docs/changelog/2026-05-22-tech-stack-rules-mysql-mcp.md

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

验证

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