yudao-pilot-mcp

# Yudao Pilot MCP [中文](#中文) | [English](#english) ## 中文 Yudao Pilot MCP 是面向 yudao / ruoyi-vue-pro 生态的工作区感知型 MCP 服务。它帮助 AI 编码工具识别本地后端、前端、数据库和代码生成目标，让 AI 生成的代码准确落到正确项目结构里。 ### 严肃声明 `yudao`、`ruoyi-vue-pro` 生态与 `ruoyi` / `RuoYi` / 若依原生生态不是同一个项目。当前 MCP 只支持 `yudao`、`ruoyi-vue-pro`、`ruoyi-vue-pro-jdk17`、`yudao-cloud` 相关项目，不支持若依原生生态项目。 ### 核心价值 - 让 AI 不再猜 yudao 项目目录和生成位置 - 用 `.yudao-pilot/config.yaml` 固化后端、前端和数据库配置 - 基于项目指纹校验路径，避免代码写错仓库或模块 - 生成菜单、字典、H2 测试 SQL 和前后端骨架代码 - 当工作目录不明确时停止初始化，并要求 AI 先询问真实项目目录 ### 安装 项目提供 `yudao-pilot` 命令入口，适合通过 pipx 或 uv 作为隔离的命令行工具安装。 推荐使用 pipx： ```bash pipx install yudao-pilot-mcp pipx ensurepath ``` 也可以使用 uv： ```bash uv tool install yudao-pilot-mcp ``` 没有 pipx 或 uv 时，使用标准虚拟环境和 pip： ```bash python3 -m venv .venv source .venv/bin/activate python -m pip install --upgrade pip python -m pip install yudao-pilot-mcp ``` Windows 使用 `.venv\Scripts\activate` 激活虚拟环境。如果当前 PyPI 镜像尚未同步新版本，显式使用官方索引： ```bash python -m pip install --index-url https://pypi.org/simple/ yudao-pilot-mcp ``` 从源码安装仅用于开发： ```bash git clone https://github.com/chanshawoh/yudao-pilot-mcp.git cd yudao-pilot-mcp python -m pip install -e ".[dev]" ``` ### 配置 MCP 客户端 通过 pipx、uv tool 或 PATH 中的 pip 环境安装后： ```json { "mcpServers": { "yudao-pilot": { "command": "yudao-pilot", "args": [] } } } ``` 如果使用项目内虚拟环境，或 MCP 客户端读取不到 shell 的 PATH： ```json { "mcpServers": { "yudao-pilot": { "command": "/absolute/path/to/.venv/bin/python", "args": ["-m", "yudao_pilot.server"] } } } ``` Windows 将 `command` 改为 `.venv\\Scripts\\python.exe` 的绝对路径。临时试用也可以让 pipx 自动创建缓存环境： ```json { "mcpServers": { "yudao-pilot": { "command": "pipx", "args": ["run", "--spec", "yudao-pilot-mcp", "yudao-pilot"] } } } ``` 长期使用推荐先执行 `pipx install`，避免 MCP 首次启动时等待下载依赖。 ### 使用 在你的 yudao 工作区中让 AI 先调用 `load_workspace_config`。首次使用会生成 `.yudao-pilot/config.yaml`，并要求确认识别到的后端和前端路径。 确认配置后，典型流程是： ```text load_workspace_config validate_workspace_proje…