{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_njespncjujq5","handle":"yudao-pilot-mcp","url":"https://wellknown.network/agents/yudao-pilot-mcp","links":{"self":"https://wellknown.network/agents/yudao-pilot-mcp/record.json","html":"https://wellknown.network/agents/yudao-pilot-mcp","markdown":"https://wellknown.network/agents/yudao-pilot-mcp/record.md","api":"https://wellknown.network/api/v1/agents/yudao-pilot-mcp","status":"https://wellknown.network/api/v1/agents/yudao-pilot-mcp/status","claim":"https://wellknown.network/agents/yudao-pilot-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/yudao-pilot-mcp/claim.json","badge":"https://wellknown.network/agents/yudao-pilot-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:yudao-pilot-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"yudao-pilot-mcp","summary":"面向 yudao 生态的 MCP 智能开发助手","description":"# Yudao Pilot MCP\n\n[中文](#中文) | [English](#english)\n\n## 中文\n\nYudao Pilot MCP 是面向 yudao / ruoyi-vue-pro 生态的工作区感知型 MCP 服务。它帮助 AI 编码工具识别本地后端、前端、数据库和代码生成目标，让 AI 生成的代码准确落到正确项目结构里。\n\n### 严肃声明\n\n`yudao`、`ruoyi-vue-pro` 生态与 `ruoyi` / `RuoYi` / 若依原生生态不是同一个项目。当前 MCP 只支持 `yudao`、`ruoyi-vue-pro`、`ruoyi-vue-pro-jdk17`、`yudao-cloud` 相关项目，不支持若依原生生态项目。\n\n### 核心价值\n\n- 让 AI 不再猜 yudao 项目目录和生成位置\n- 用 `.yudao-pilot/config.yaml` 固化后端、前端和数据库配置\n- 基于项目指纹校验路径，避免代码写错仓库或模块\n- 生成菜单、字典、H2 测试 SQL 和前后端骨架代码\n- 当工作目录不明确时停止初始化，并要求 AI 先询问真实项目目录\n\n### 安装\n\n项目提供 `yudao-pilot` 命令入口，适合通过 pipx 或 uv 作为隔离的命令行工具安装。\n\n推荐使用 pipx：\n\n```bash\npipx install yudao-pilot-mcp\npipx ensurepath\n```\n\n也可以使用 uv：\n\n```bash\nuv tool install yudao-pilot-mcp\n```\n\n没有 pipx 或 uv 时，使用标准虚拟环境和 pip：\n\n```bash\npython3 -m venv .venv\nsource .venv/bin/activate\npython -m pip install --upgrade pip\npython -m pip install yudao-pilot-mcp\n```\n\nWindows 使用 `.venv\\Scripts\\activate` 激活虚拟环境。如果当前 PyPI 镜像尚未同步新版本，显式使用官方索引：\n\n```bash\npython -m pip install --index-url https://pypi.org/simple/ yudao-pilot-mcp\n```\n\n从源码安装仅用于开发：\n\n```bash\ngit clone https://github.com/chanshawoh/yudao-pilot-mcp.git\ncd yudao-pilot-mcp\npython -m pip install -e \".[dev]\"\n```\n\n### 配置 MCP 客户端\n\n通过 pipx、uv tool 或 PATH 中的 pip 环境安装后：\n\n```json\n{\n  \"mcpServers\": {\n    \"yudao-pilot\": {\n      \"command\": \"yudao-pilot\",\n      \"args\": []\n    }\n  }\n}\n```\n\n如果使用项目内虚拟环境，或 MCP 客户端读取不到 shell 的 PATH：\n\n```json\n{\n  \"mcpServers\": {\n    \"yudao-pilot\": {\n      \"command\": \"/absolute/path/to/.venv/bin/python\",\n      \"args\": [\"-m\", \"yudao_pilot.server\"]\n    }\n  }\n}\n```\n\nWindows 将 `command` 改为 `.venv\\\\Scripts\\\\python.exe` 的绝对路径。临时试用也可以让 pipx 自动创建缓存环境：\n\n```json\n{\n  \"mcpServers\": {\n    \"yudao-pilot\": {\n      \"command\": \"pipx\",\n      \"args\": [\"run\", \"--spec\", \"yudao-pilot-mcp\", \"yudao-pilot\"]\n    }\n  }\n}\n```\n\n长期使用推荐先执行 `pipx install`，避免 MCP 首次启动时等待下载依赖。\n\n### 使用\n\n在你的 yudao 工作区中让 AI 先调用 `load_workspace_config`。首次使用会生成 `.yudao-pilot/config.yaml`，并要求确认识别到的后端和前端路径。\n\n确认配置后，典型流程是：\n\n```text\nload_workspace_config\nvalidate_workspace_proje…","publisher":{"name":"Yudao Pilot Contributors","url":null},"homepage":null,"repository":null,"version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:yudao-pilot-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"yudao-pilot-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:30.833Z","publishedAt":"2026-09-04T03:13:19.584334Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"yudao-pilot-mcp","url":"https://pypi.org/project/yudao-pilot-mcp/","firstSeenAt":"2026-09-10T16:23:36.862Z","fetchedAt":"2026-09-10T16:23:36.862Z","normalizedAt":"2026-09-10T16:23:36.862Z"}]},"firstSeenAt":"2026-09-10T16:23:36.862Z","updatedAt":"2026-09-10T16:24:30.833Z"}