# 安装 three.ws Avatars

- 类型: MCP 工具
- 说明: 在智能体中嵌入可交互的实时3D虚拟形象并生成嵌入展示。
- 仓库: https://github.com/nirholas/three.ws
- ⚠ 安全: 该 MCP 工具材料很少，但从已知信息看，来源较可信且开源，可审计性尚可。其主要风险点属于 MCP 工具常见能力范畴：本机执行代码，以及可能依据 THREEWS_BASE_URL 发起网络连接，因此整体以需留意为主，未见足以定为高风险的明确红旗。

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "three.ws Avatars" MCP 服务：
执行：claude mcp add io-github-nirholas-threews-avatar -- npx -y @three-ws/avatar-mcp
```

### Codex
```
请帮我安装 askskill 上的 "three.ws Avatars" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-nirholas-threews-avatar]
command = "npx"
args = ["-y","@three-ws/avatar-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "three.ws Avatars" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-nirholas-threews-avatar": { "command": "npx", "args": ["-y","@three-ws/avatar-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env THREEWS_BASE_URL=YOUR_VALUE --transport stdio io-github-nirholas-threews-avatar -- npx -y @three-ws/avatar-mcp
```
需要环境变量：THREEWS_BASE_URL

### Codex
```bash
codex mcp add --env THREEWS_BASE_URL=YOUR_VALUE io-github-nirholas-threews-avatar -- npx -y @three-ws/avatar-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-nirholas-threews-avatar]
command = "npx"
args = ["-y","@three-ws/avatar-mcp"]

[mcp_servers.io-github-nirholas-threews-avatar.env]
THREEWS_BASE_URL = "YOUR_VALUE"
```
需要环境变量：THREEWS_BASE_URL

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-nirholas-threews-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-mcp"
      ],
      "env": {
        "THREEWS_BASE_URL": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-nirholas-threews-avatar&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy9hdmF0YXItbWNwIl0sImVudiI6eyJUSFJFRVdTX0JBU0VfVVJMIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：THREEWS_BASE_URL