opsmaxx

Name: opsmaxx
Author: OpsMaxx

本地服务

opsmaxx.dev云与基础设施07 周前更新

代码仓库访问官网

关于 opsmaxx

opsmaxx 是供 stdio MCP 客户端连接正在运行的 OpsMaxx 桌面应用的协议中继，适用于无法配置 HTTP MCP 服务的客户端。它原样转发消息，访问控制、审批和审计仍由应用处理。

主要功能

01在 stdio 与 HTTP 间中继 MCP 消息
02使用本地 OpsMaxx 桥接端点
03复用应用中的访问组与审批策略
04沿用应用的密钥脱敏和审计日志
05支持通过环境变量或 CLI 缓存配置会话

适用场景

01让无法配置 HTTP 的客户端连接 OpsMaxx
02将 Claude Desktop 接入本地 MCP 桥接端点
03沿用 OpsMaxx 的访问组和审批控制
04让 stdio 客户端使用应用审计日志

MCP 相关

该工具是协议中继，不是 MCP 服务；它将 stdio MCP 客户端连接到运行中的 OpsMaxx 桌面应用，通过本地 Streamable HTTP 桥接端点转发消息。工具逻辑和策略仍由应用处理。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "opsmaxx-opsmaxx": {
      "command": "npx",
      "args": [
        "-y",
        "@opsmaxx/mcp"
      ],
      "env": {
        "OPSMAXX_MCP_TOKEN": "<OPSMAXX_MCP_TOKEN>",
        "OPSMAXX_MCP_PORT": "<OPSMAXX_MCP_PORT>"
      }
    }
  }
}

启动命令npx -y @opsmaxx/mcp

需要配置的环境变量

OPSMAXX_MCP_TOKEN密钥Session token from AI & MCP -> AI Agents -> New AI agent session in the OpsMaxx app. Scoped to one workspace and one access group.

OPSMAXX_MCP_PORTPort the OpsMaxx MCP bridge listens on, shown under AI & MCP -> Security. Defaults to the session cached by the opsmaxx CLI.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@opsmaxx/mcp0.1.3stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@opsmaxx/mcp

将任意 stdio MCP 客户端连接到正在运行的 OpsMaxx 桌面应用。

npx -y @opsmaxx/mcp

为什么需要它

OpsMaxx 已通过 Streamable HTTP 在 127.0.0.1 上提供 MCP 服务，能够配置带有 Authorization 标头的 HTTP 服务的客户端——Claude Code、Codex——应直接使用该服务。只需一条命令：

opsmaxx claude

有些客户端无法做到这一点。尤其是 Claude Desktop，它完全不会从 claude_desktop_config.json 读取 url 或 headers，因此无法在其中配置 HTTP MCP 服务。这个包就是为这些客户端提供的适配器：输入 stdio，输出经过身份验证的 HTTP。

它能做什么，不能做什么

它是一个协议中继。每条消息都会在两个方向上原样转发。这里没有工具、会话或策略逻辑——访问组、审批、密钥脱敏和审计日志都由应用处理，因此 stdio 客户端受到的处理与 HTTP 客户端完全相同。

它只与 127.0.0.1 通信。它不是服务，不保存状态，也无法访问 OpsMaxx 原本不允许访问的任何内容。

OpsMaxx 必须正在运行，并且已在 AI & MCP 下启用桥接。

配置

先读取环境变量，再读取 opsmaxx CLI 已缓存的会话：

变量	含义
`OPSMAXX_MCP_TOKEN`	来自 AI & MCP → AI Agents → New AI agent session 的会话令牌
`OPSMAXX_MCP_PORT`	桥接端口，显示在 AI & MCP → Security 下
`OPSMAXX_MCP_URL`	完整端点，用于替代端口，例如 `http://127.0.0.1:5177/mcp`

如果都未设置，它会读取 CLI 缓存的会话，因此只需运行一次 opsmaxx claude，无需粘贴令牌。

Claude Desktop

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

之后重启 Claude Desktop。