English Français العربية

io.github.OpsMaxx/opsmaxx

السجل الرسمي البيانات وقواعدها

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @opsmaxx/mcp
Claude Code 
claude mcp add opsmaxx -e 'OPSMAXX_MCP_TOKEN=<your opsmaxx_mcp_token>' -e 'OPSMAXX_MCP_PORT=<OPSMAXX_MCP_PORT>' -- npx -y @opsmaxx/mcp@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "opsmaxx": {
            "command": "npx",
            "args": [
                "-y",
                "@opsmaxx/mcp@0.1.3"
            ],
            "env": {
                "OPSMAXX_MCP_TOKEN": "<your opsmaxx_mcp_token>",
                "OPSMAXX_MCP_PORT": "<OPSMAXX_MCP_PORT>"
            }
        }
    }
}

متغيرات البيئة

  • 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_PORT Port the OpsMaxx MCP bridge listens on, shown under AI & MCP -> Security. Defaults to the session cached by the opsmaxx CLI.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @opsmaxx/mcp
  2. Why this exists
  3. What it does, and does not
  4. Configuration
  5. A note on the token
  6. Licence

@opsmaxx/mcp

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

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:

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
{
  "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

الأسئلة الشائعة

ما هو io.github.OpsMaxx/opsmaxx؟

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

كيف أثبّت io.github.OpsMaxx/opsmaxx؟

يعمل على جهازك. في Claude Code: claude mcp add opsmaxx -e 'OPSMAXX_MCP_TOKEN=<your opsmaxx_mcp_token>' -e 'OPSMAXX_MCP_PORT=<OPSMAXX_MCP_PORT>' -- npx -y @opsmaxx/mcp@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.OpsMaxx/opsmaxx إلى مفتاح API؟

نعم. يتطلب OPSMAXX_MCP_TOKEN، وتضبطها في إعداداته.

هل io.github.OpsMaxx/opsmaxx مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.OpsMaxx/opsmaxx؟

ينشره OpsMaxx. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.