MCP Openmediavault

mcp openmediavault

A. 模型上下文协议（MCP） 服务器 OpenMediaVault（OMV），通过OMV JSON-RPC API为AI助手提供对NAS存储、共享、用户和系统管理的完全访问。

兼容 OMV 5和OMV 6.

特性

33工具 分为五类：

系统

存储

股份

用户和组

服务

安装

git clone git@github.com:fredriksknese/mcp-openmediavault.git
cd mcp-openmediavault
npm install
npm run build

配置

服务器是通过环境变量配置的：

OMV 5/OMV 6兼容性

服务器连接到JSON-RPC端点 https://{host}/rpc.php，这是OMV 5和OMV 6的标准端点。

会话管理遵循OMV协议：

1. 通过登录 POST /rpc.php 随着 Session.login
2. 提取会话cookie(PHPSESSID)从 Set-Cookie 响应头
3. 发送这两个 Cookie 标题和 X-OPENMEDIAVAULT-SESSIONID 所有后续请求的标头

如果会话过期（HTTP 401），客户端会自动重新进行身份验证并重试。

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "openmediavault": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-openmediavault/dist/index.js"],
      "env": {
        "OMV_HOST": "192.168.1.100",
        "OMV_USERNAME": "admin",
        "OMV_PASSWORD": "your-password"
      }
    }
  }
}

使用Claude代码

claude mcp add openmediavault -- node /absolute/path/to/mcp-openmediavault/dist/index.js

运行前设置环境变量，或在MCP设置中配置它们。

示例提示

连接后，您可以向您的AI助手询问以下问题：

• *“当前磁盘使用情况如何，装载了哪些文件系统？”*
• *“显示所有磁盘的SMART运行状况”*
• *“列出所有SMB共享及其启用状态”*
• *“NAS上当前正在运行哪些服务？”*
• *“显示所有用户及其组成员身份”*
• *“OMV有可用的软件更新吗？”*
• *“计划了哪些cron作业，它们什么时候运行？”*
• *“显示NFS导出配置”*
• *“CPU温度和系统负载是多少？”*

发展

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

建筑

src/
├── index.ts          # Entry point — creates MCP server + STDIO transport
├── omv-client.ts     # JSON-RPC client with session management and auto-retry
└── tools/
    ├── system.ts     # System info, stats, network interfaces (6 tools)
    ├── storage.ts    # Disks, filesystems, SMART, RAID (8 tools)
    ├── shares.ts     # Shared folders, SMB, NFS, FTP (8 tools)
    ├── users.ts      # Users and groups (7 tools)
    └── services.ts   # Services status, cron, SSH, rsync, plugins (10 tools)

需求

• Node.js 18+
• 具有管理员凭据的OpenMediaVault 5或6
• 具有API访问权限的管理员帐户（默认 admin 账户工作）

许可证

请参阅许可证中的许可证