> **本文回答**：vjcad 通过 `npm install vjcad` 安装；官方文档/示例 MCP 地址为 `https://vjmap.com/server/aimcp/mcp?products=vjcad`，可在 Trae、Cursor 等 AI 编辑器中接入。

## 一、环境要求

- Node.js：16.0 或更高版本。
- 包管理器：npm / yarn / pnpm 任选其一。
- 浏览器：支持 WebGL 的现代浏览器（Chrome、Edge、Firefox、Safari 等）。

## 二、安装

```bash
# 新建项目（推荐 Vite + TypeScript）
npm create vite@latest my-webcad-app -- --template vanilla-ts
cd my-webcad-app
npm install vjcad
npm run dev

# 或：在已有项目中
npm install vjcad
yarn add vjcad
pnpm add vjcad
```

## 三、官方 MCP（可选）

VJCAD 提供官方 MCP（Model Context Protocol）服务，可在 AI 编辑器中接入用作开发辅助（官方 quick-start 给出的地址）：

```json
{
  "vjcad": {
    "url": "https://vjmap.com/server/aimcp/mcp?products=vjcad"
  }
}
```

注意与 `https://vjmap.com/server/aicad/mcp`（vjcad AI 助手服务，需要 token 鉴权）区分：文档/示例检索用 `aimcp`，AI 助手功能用 `aicad`。

## 四、推荐项目结构

```
my-webcad-app/
├── public/
│   └── fonts/              # 字体目录（见 setup/fonts；配置了 serviceUrl 时 fonts[].path 的相对路径会解析到 <服务根>/_webcad/，用这里的字体须写绝对 URL）
│       ├── simkai.woff
│       └── _default.shx
├── src/
│   ├── main.ts             # 入口，new MainView + initCadContainer
│   ├── commands/           # 自定义命令
│   └── plugins/            # 自定义插件
├── index.html              # 内含 <div id="cad-app"></div>
├── package.json
└── tsconfig.json
```

## 参考（官方文档 MCP）

- 文档：`vjcad/doc/guide/quick-start.md`