Opsmaxx

io.github.OpsMaxx由 GitHub 账号 OpsMaxx 发布v0.1.3更新于 Oct 25, 2026

SSH, files, containers and databases via the OpsMaxx desktop app - scoped per capability, audited.

已验证STDIO仅桌面云端与基础设施开发者工具

概览

AI 生成的概览

一个本地 stdio 适配器，把 MCP 客户端中继到正在运行的 OpsMaxx 桌面应用，按能力范围提供经审计的 SSH、文件、容器和数据库访问。

可以做什么
在 stdio 客户端与 OpsMaxx 桌面应用之间通过带认证的本地 HTTP 双向原样转发 MCP 消息，使客户端获得与 HTTP 客户端相同的工具和策略处理。通过该应用访问 SSH 主机、文件、容器和数据库，按能力限定范围并记录审计。访问组、审批、密钥脱敏和审计日志都由应用负责，而非适配器。可通过环境变量或 opsmaxx CLI 已缓存的会话配置连接。
适用场景
当你的 MCP 客户端无法表达带 Authorization 头的 HTTP MCP 服务器（例如 Claude Desktop），又希望它与正在运行的 OpsMaxx 桌面应用配合时使用。能直接连接 HTTP 服务器的客户端应绕过此适配器直接连接 OpsMaxx。
运行要求
同一台机器上正在运行的 OpsMaxx 桌面应用，并在 AI & MCP 中启用桥接；适配器只连接 127.0.0.1。需要 Node.js 运行该 npm 包。需要 OPSMAXX_MCP_TOKEN 中的会话令牌，或 opsmaxx CLI 已缓存的会话；也可设置 OPSMAXX_MCP_PORT 或 OPSMAXX_MCP_URL 而不依赖缓存。仅限桌面端。
安装前请注意
OPSMAXX_MCP_TOKEN 是限定于一个工作区和一个访问组的密钥，不要放入共享配置。适配器本身不保存状态，也无法超出 OpsMaxx 已允许的范围，但它暴露的工具可操作 SSH 主机、文件、容器和数据库，因此在令牌范围内可能发生写入和变更，并会在应用中审计。它不会把 SSH 密码、私钥、数据库凭据或 root shell 交给智能体。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Opsmaxx，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@opsmaxx/mcp

Connect any stdio MCP client to a running OpsMaxx desktop app.

bash
npx -y @opsmaxx/mcp

Why this exists

OpsMaxx already exposes an MCP server over Streamable HTTP on 127.0.0.1, and clients that can express an HTTP server with an Authorization header — Claude Code, Codex — should use that directly. It is one command:

bash
opsmaxx claude

Some clients cannot. Claude Desktop, notably, does not read url or headers from claude_desktop_config.json at all, so an HTTP MCP server is simply not expressible there. This package is the adapter for those: stdio in, authenticated HTTP out.

What it does, and does not

It is a protocol relay. Every message is forwarded unmodified in both directions. No tool, session or policy logic lives here — access groups, approvals, secret redaction and the audit log all stay in the app, so a stdio client gets exactly the same treatment an HTTP client would.

It talks only to 127.0.0.1. It is not a server, it holds no state, and it cannot reach anything OpsMaxx would not already allow.

OpsMaxx must be running, with the bridge enabled under AI & MCP.

Configuration

Environment first, then the session the opsmaxx CLI has already cached:

VariableMeaning
OPSMAXX_MCP_TOKENSession token from AI & MCP → AI Agents → New AI agent session
OPSMAXX_MCP_PORTBridge port, shown under AI & MCP → Security
OPSMAXX_MCP_URLFull endpoint instead of the port, e.g. http://127.0.0.1:5177/mcp

If none are set it reads the session cached by the CLI, so running opsmaxx claude once is enough and there is no token to paste.

Claude Desktop

json
{  "mcpServers": {    "opsmaxx": {      "command": "npx",      "args": ["-y", "@opsmaxx/mcp"],      "env": {        "OPSMAXX_MCP_TOKEN": "your-session-token",        "OPSMAXX_MCP_PORT": "5177"      }    }  }}

Restart Claude Desktop afterwards.

A note on the token

The token is scoped to one workspace and one access group, and it is the same secret you would otherwise paste into a client's config by hand. It is not an SSH key and it is not a vault password: an agent holding it still never receives an SSH password, a private key, a database credential, a hostname or an interactive root shell. See the threat model.

Licence

MIT. Source: https://github.com/OpsMaxx/OpsMaxx

来源：README.md，提交 7a0c062

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。