anov-dev-copilot-mcp

anov-dev-copilot-mcp 是 ANOV-DEV Copilot 的核心引擎层，它是一个完全符合 Model Context Protocol (MCP) 标准的服务端实现。

它的主要作用是作为"桥梁"挂载在 AI Agent（如 Claude Code、Cursor、Antigravity）上，赋予 AI 主动创建云端项目、获取模板、解压文件以及验证本地项目环境的动态能力。

环境变量

启动该服务需要通过环境变量传入鉴权信息和 API 地址。在 MCP 编辑器配置中通过 env 字段注入（推荐），或在本地开发时创建 .env 文件：

| 变量名 | 说明 | | :--- | :--- | | API_BASE_URL | ANOV 接口服务的 Base URL（如 https://api.anov.dev） | | ACCESS_TICKET | 调用 ANOV 接口的访问令牌 |

提供的工具 (Tools)

该 MCP Server 向 AI 注册了以下 5 个工具：

anov-list-versions

列出 ANOV-DEV 框架的最新可用版本。

• 参数：无
• 返回：最新框架的 name 和 version 信息（JSON）
• 接口：GET /console/v1/devs/demos/v1

anov-create-project

在 ANOV 云端创建一个新的可视化大屏项目。

• 参数：

  | 参数名 | 类型 | 必填 | 说明 | | :--- | :--- | :--- | :--- | | screenName | string | ✅ | 大屏名称（2-50 字符） | | frameworkVersion | string | ✅ | 要使用的框架版本 | | screenRemark | string | ❌ | 大屏描述/备注 | | tenantCode | string | ❌ | 租户代码（有默认值） | | deptCode | string | ❌ | 部门代码（有默认值） | | screenType | number | ❌ | 大屏类型（默认 2） | | ueEnabled | boolean | ❌ | 是否开启流媒体（默认 false） | | (其他 UE 相关参数) | - | ❌ | 流媒体连接数等高级配置 |

• 接口：POST /console/v1/devs/v1

anov-get-latest-project

获取最近创建的大屏项目的 screenKey。

• 参数：无
• 返回：最近项目的 screenKey 字符串
• 接口：GET /console/v1/devs/v1/conditions（按创建时间倒序取第一条）

anov-download-template

下载并解压指定大屏项目的工程模板到本地目录。

• 参数：

  | 参数名 | 类型 | 必填 | 说明 | | :--- | :--- | :--- | :--- | | screenKey | string | ✅ | 目标大屏的唯一标识符 | | targetDir | string | ❌ | 解压目标目录（相对工作区根目录，默认 ".") | | overwrite | boolean | ❌ | 是否覆盖已有文件（默认 true） |

• 安全机制：Zip-Slip 保护——所有文件只能解压到项目根目录内，拒绝路径穿越攻击。

• 接口：GET /console/v1/devs/v1/{screenKey}/download-source

anov-check-project

检测指定目录是否为有效的 ANOV-DEV 项目。

• 参数：

  | 参数名 | 类型 | 必填 | 说明 | | :--- | :--- | :--- | :--- | | projectDir | string | ✅ | 待验证的项目根目录的绝对路径 | | requireOmniUi | boolean | ❌ | 是否同时验证 @anov/omni-ui 组件库已安装（默认 false） |

• 检测逻辑：判断目录下是否存在 package.json，且其中包含至少一个 @anov/ 前缀的依赖包。

• 用途：集中化的项目环境检测，无论 Skills 安装在何处都可以路径无关地调用。

提供的提示词 (Prompts)

anov-project-init

引导 AI 按标准流程完成 ANOV 大屏项目的初始化与模板下载。

标准工作流：

1. 调用 anov-list-versions 获取最新框架版本
2. 调用 anov-create-project 创建大屏项目
3. 调用 anov-get-latest-project 获取新项目的 screenKey
4. 向用户确认后再执行下载（安全防护）
5. 调用 anov-download-template 下载并解压到工作区

在 AI 编辑器中集成

推荐方式（npx，无需本地安装）

{
  "mcpServers": {
    "anov-dev-copilot": {
      "command": "npx",
      "args": ["-y", "anov-dev-copilot-mcp"],
      "env": {
        "API_BASE_URL": "你的_ANOV_API_BASE_URL",
        "ACCESS_TICKET": "你的_ANOV_ACCESS_TICKET"
      }
    }
  }
}

开发模式（本地构建产物）

{
  "mcpServers": {
    "anov-dev-copilot": {
      "command": "node",
      "args": ["/绝对路径/到/anov-dev-mcp/packages/mcp/dist/index.js"],
      "env": {
        "API_BASE_URL": "你的_ANOV_API_BASE_URL",
        "ACCESS_TICKET": "你的_ANOV_ACCESS_TICKET"
      }
    }
  }
}

提示：配置完成后，请务必重启 AI 编辑器或在 MCP 面板中重载 (Reload) 该 MCP Server，以使配置生效。

开发与构建

# 在 packages/mcp 目录下执行构建
pnpm build

# 启动热更新监视模式
pnpm dev