# 安装 Unraid MCP

- 类型: MCP 工具
- 说明: 连接 Unraid 的 GraphQL API，帮助查询服务器状态并执行运维操作。
- 仓库: https://github.com/jmagar/unraid-mcp
- ⚠ 安全: 该 MCP 工具主要用于通过 GraphQL API 管理/交互 Unraid 服务器，已知需要 API URL 与 API Key，并会执行本地服务进程。基于官方 Registry、开源且近期维护，整体未见明确高风险红旗，但因涉及敏感管理凭证、网络连接到用户配置的 Unraid 端点与潜在主机管理能力，建议按需谨慎部署。

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

### Claude Code
```
请帮我安装 askskill 上的 "Unraid MCP" MCP 服务：
执行：claude mcp add tv-tootie-unraid-mcp -- uvx unraid-mcp
```

### Codex
```
请帮我安装 askskill 上的 "Unraid MCP" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.tv-tootie-unraid-mcp]
command = "uvx"
args = ["unraid-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Unraid MCP" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"tv-tootie-unraid-mcp": { "command": "uvx", "args": ["unraid-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

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

### Claude Code
```bash
claude mcp add --env UNRAID_API_URL=YOUR_VALUE --env UNRAID_API_KEY=YOUR_VALUE --transport stdio tv-tootie-unraid-mcp -- uvx unraid-mcp
```
需要环境变量：UNRAID_API_URL, UNRAID_API_KEY

### Codex
```bash
codex mcp add --env UNRAID_API_URL=YOUR_VALUE --env UNRAID_API_KEY=YOUR_VALUE tv-tootie-unraid-mcp -- uvx unraid-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.tv-tootie-unraid-mcp]
command = "uvx"
args = ["unraid-mcp"]

[mcp_servers.tv-tootie-unraid-mcp.env]
UNRAID_API_URL = "YOUR_VALUE"
UNRAID_API_KEY = "YOUR_VALUE"
```
需要环境变量：UNRAID_API_URL, UNRAID_API_KEY

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "tv-tootie-unraid-mcp": {
      "command": "uvx",
      "args": [
        "unraid-mcp"
      ],
      "env": {
        "UNRAID_API_URL": "YOUR_VALUE",
        "UNRAID_API_KEY": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=tv-tootie-unraid-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ1bnJhaWQtbWNwIl0sImVudiI6eyJVTlJBSURfQVBJX1VSTCI6IllPVVJfVkFMVUUiLCJVTlJBSURfQVBJX0tFWSI6IllPVVJfVkFMVUUifX0
需要环境变量：UNRAID_API_URL, UNRAID_API_KEY