内容
# Unraid
<!-- mcp-name: tv.tootie/unraid-mcp -->
[](https://pypi.org/project/unraid-mcp/) [](https://github.com/dinglebear-ai/unraid/pkgs/container/unraid-mcp)
Unraid 工具的 monorepo：两个 MCP 服务器（Python 和 Rust）和三个 Unraid OS 插件，以及 Claude/Codex 代理集成。
## 组件
| 路径 | 描述 | 工具链 | 构建/测试 |
|------|-----------|-----------|--------------|
| [`unraid-py/`](unraid-py/) | **unraid-mcp** — Python MCP 服务器（GraphQL），旗舰版。发布到 PyPI 作为 `unraid-mcp`。 | Python / uv / hatchling | `cd unraid-py && uv run pytest && uv build --wheel` |
| [`unraid-rs/`](unraid-rs/) | **runraid** — Rust MCP 服务器 + CLI（单个静态二进制文件），`unraid-rmcp` 在 npm 上。 | Rust / cargo | `cd unraid-rs && cargo fmt --check && cargo clippy --all-targets -- -D warnings && cargo test` |
| [`plugins/mcp/`](plugins/mcp/) | Unraid OS 插件，将 Python MCP 服务器部署到 Unraid 盒子上。 | shell `.plg` + Python | `bash plugins/mcp/scripts/build-txz.sh <ver> <wheel>` |
| [`plugins/incus/`](plugins/incus/) | Unraid OS 插件，运行 Incus 系统容器（“开发容器”），与 LAN 隔离。包括 NestJS/GraphQL `unraid-api` 后端。 | shell `.plg` + NestJS/Vue | `cd plugins/incus && ./scripts/verify-classic-package.sh && ./tests/classic-contract.sh` |
| [`plugins/codex/`](plugins/codex/) | Unraid OS 插件，嵌入 Codex 聊天应用服务器。 | shell `.plg` + React | `cd plugins/codex && ./tests/contract.sh` |
| [`agents/unraid-py/`](agents/unraid-py/) | Claude Code / Codex 插件（`name: unraid-mcp`）适用于 Python 服务器。 | — | — |
| [`agents/unraid-rs/`](agents/unraid-rs/) | Claude Code / Codex 插件（`name: runraid`）适用于 Rust 服务器。 | — | — |
## 安装代理插件（一个市场命令，两个清单）
```text
/plugin marketplace add dinglebear-ai/unraid
/plugin install unraid-mcp@unraid-mcp # Python 服务器
/plugin install runraid@unraid-mcp # Rust 服务器
```
两个插件都从单个仓库发布。Claude 读取 `.claude-plugin/marketplace.json`；Codex 读取 `.agents/plugins/marketplace.json`。`meta-ci.yml` 断言两个列表相同的插件集，因此它们不会漂移。
`marketplace add` 接受 `owner/repo` 简写（或完整的 git URL / 本地路径）。安装后，Claude Code 提示连接设置（插件的 `userConfig`）并将它们持久化到 `~/.unraid-mcp/.env`。
## unraid-py 快速入门（Python MCP 服务器）
Python 服务器是旗舰版。完整的文档 — 安装，Claude Code / Codex / Gemini 设置，配置，身份验证，防护措施和工具表面 — 位于 **[`unraid-py/README.md`](unraid-py/README.md)** 和 [`unraid-py/docs/`](unraid-py/docs/) 中。它发布到 PyPI 作为 `unraid-mcp`（导入包 `unraid_mcp`）并使用 `uvx unraid-mcp` 启动。
## 版本发布
版本控制由 release-please 在所有四个发布单元中驱动。Python 服务器保留无前缀的 `vX.Y.Z` 标签（现有受众的方案）；其他组件使用前缀标签：`unraid-rs-vX.Y.Z`，`incus-vX.Y.Z`，`codex-vX.Y.Z`。插件 `.txz` 有效负载作为 GitHub **发布资产**，不在 git 中跟踪。
## 许可证
MIT — 见 [LICENSE](LICENSE)。
