# 安装 3D AI Agent Avatar

- 类型: MCP 工具
- 说明: 帮助你渲染3D智能体形象，并集成语音、Solana钱包与代币互动能力。
- 仓库: https://github.com/nirholas/three.ws

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

### Claude Code
```
请帮我安装 askskill 上的 "3D AI Agent Avatar" MCP 服务：
执行：claude mcp add io-github-nirholas-3d-ai-agent-avatar -- npx -y @three-ws/avatar-agent
```

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

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

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

### Claude Code
```bash
claude mcp add --env SOLANA_RPC_URL=YOUR_VALUE --env ETH_RPC_URL=YOUR_VALUE --env HELIUS_API_KEY=YOUR_VALUE --env NVIDIA_API_KEY=YOUR_VALUE --env OPENAI_API_KEY=YOUR_VALUE --env REPLICATE_API_TOKEN=YOUR_VALUE --env REPLICATE_TEXT_TO_AVATAR_MODEL=YOUR_VALUE --env SOLANA_SECRET_KEY=YOUR_VALUE --env THREE_MINT=YOUR_VALUE --env MAX_SOL_PER_TX=YOUR_VALUE --env REQUIRE_CONFIRM=YOUR_VALUE --transport stdio io-github-nirholas-3d-ai-agent-avatar -- npx -y @three-ws/avatar-agent
```
需要环境变量：SOLANA_RPC_URL, ETH_RPC_URL, HELIUS_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, REPLICATE_API_TOKEN, REPLICATE_TEXT_TO_AVATAR_MODEL, SOLANA_SECRET_KEY, THREE_MINT, MAX_SOL_PER_TX, REQUIRE_CONFIRM

### Codex
```bash
codex mcp add --env SOLANA_RPC_URL=YOUR_VALUE --env ETH_RPC_URL=YOUR_VALUE --env HELIUS_API_KEY=YOUR_VALUE --env NVIDIA_API_KEY=YOUR_VALUE --env OPENAI_API_KEY=YOUR_VALUE --env REPLICATE_API_TOKEN=YOUR_VALUE --env REPLICATE_TEXT_TO_AVATAR_MODEL=YOUR_VALUE --env SOLANA_SECRET_KEY=YOUR_VALUE --env THREE_MINT=YOUR_VALUE --env MAX_SOL_PER_TX=YOUR_VALUE --env REQUIRE_CONFIRM=YOUR_VALUE io-github-nirholas-3d-ai-agent-avatar -- npx -y @three-ws/avatar-agent
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-nirholas-3d-ai-agent-avatar]
command = "npx"
args = ["-y","@three-ws/avatar-agent"]

[mcp_servers.io-github-nirholas-3d-ai-agent-avatar.env]
SOLANA_RPC_URL = "YOUR_VALUE"
ETH_RPC_URL = "YOUR_VALUE"
HELIUS_API_KEY = "YOUR_VALUE"
NVIDIA_API_KEY = "YOUR_VALUE"
OPENAI_API_KEY = "YOUR_VALUE"
REPLICATE_API_TOKEN = "YOUR_VALUE"
REPLICATE_TEXT_TO_AVATAR_MODEL = "YOUR_VALUE"
SOLANA_SECRET_KEY = "YOUR_VALUE"
THREE_MINT = "YOUR_VALUE"
MAX_SOL_PER_TX = "YOUR_VALUE"
REQUIRE_CONFIRM = "YOUR_VALUE"
```
需要环境变量：SOLANA_RPC_URL, ETH_RPC_URL, HELIUS_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, REPLICATE_API_TOKEN, REPLICATE_TEXT_TO_AVATAR_MODEL, SOLANA_SECRET_KEY, THREE_MINT, MAX_SOL_PER_TX, REQUIRE_CONFIRM

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-nirholas-3d-ai-agent-avatar": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/avatar-agent"
      ],
      "env": {
        "SOLANA_RPC_URL": "YOUR_VALUE",
        "ETH_RPC_URL": "YOUR_VALUE",
        "HELIUS_API_KEY": "YOUR_VALUE",
        "NVIDIA_API_KEY": "YOUR_VALUE",
        "OPENAI_API_KEY": "YOUR_VALUE",
        "REPLICATE_API_TOKEN": "YOUR_VALUE",
        "REPLICATE_TEXT_TO_AVATAR_MODEL": "YOUR_VALUE",
        "SOLANA_SECRET_KEY": "YOUR_VALUE",
        "THREE_MINT": "YOUR_VALUE",
        "MAX_SOL_PER_TX": "YOUR_VALUE",
        "REQUIRE_CONFIRM": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-nirholas-3d-ai-agent-avatar&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy9hdmF0YXItYWdlbnQiXSwiZW52Ijp7IlNPTEFOQV9SUENfVVJMIjoiWU9VUl9WQUxVRSIsIkVUSF9SUENfVVJMIjoiWU9VUl9WQUxVRSIsIkhFTElVU19BUElfS0VZIjoiWU9VUl9WQUxVRSIsIk5WSURJQV9BUElfS0VZIjoiWU9VUl9WQUxVRSIsIk9QRU5BSV9BUElfS0VZIjoiWU9VUl9WQUxVRSIsIlJFUExJQ0FURV9BUElfVE9LRU4iOiJZT1VSX1ZBTFVFIiwiUkVQTElDQVRFX1RFWFRfVE9fQVZBVEFSX01PREVMIjoiWU9VUl9WQUxVRSIsIlNPTEFOQV9TRUNSRVRfS0VZIjoiWU9VUl9WQUxVRSIsIlRIUkVFX01JTlQiOiJZT1VSX1ZBTFVFIiwiTUFYX1NPTF9QRVJfVFgiOiJZT1VSX1ZBTFVFIiwiUkVRVUlSRV9DT05GSVJNIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：SOLANA_RPC_URL, ETH_RPC_URL, HELIUS_API_KEY, NVIDIA_API_KEY, OPENAI_API_KEY, REPLICATE_API_TOKEN, REPLICATE_TEXT_TO_AVATAR_MODEL, SOLANA_SECRET_KEY, THREE_MINT, MAX_SOL_PER_TX, REQUIRE_CONFIRM