Back to Home
acuvity icon

maxibridge

by acuvity

Overview

Maxibridge acts as a policeable dynamic gateway for Multiple Context Protocol (MCP) servers, allowing external agents to connect, discover, and interact with various backend MCP services with security and policy enforcement.

Installation

Run Command
maxibridge backend --listen :8080 --mcp-server-name my-mcp-server --registration-url http://localhost:8081 -- cat

Environment Variables

  • MAXIBRIDGE_CONFIG
  • MAXIBRIDGE_CONFIG_NAME
  • MAXIBRIDGE_LOG_LEVEL
  • MAXIBRIDGE_LOG_FORMAT
  • MAXIBRIDGE_LISTEN
  • MAXIBRIDGE_REGISTRATION_LISTEN
  • MAXIBRIDGE_MCP_SERVER_NAME
  • MAXIBRIDGE_REGISTRATION_URL
  • MAXIBRIDGE_PUBLIC_URL
  • MAXIBRIDGE_AGENT_TOKEN
  • MAXIBRIDGE_POLICER_TYPE
  • MAXIBRIDGE_POLICER_REGO_POLICY
  • MAXIBRIDGE_POLICER_HTTP_URL
  • MAXIBRIDGE_GATEWAY_NAME
  • MAXIBRIDGE_GATEWAY_REPORT_TOKEN
  • OTEL_EXPORTER_OTLP_ENDPOINT
  • REGO_POLICY_RUNTIME_*

Security Notes

The backend component of Maxibridge directly executes arbitrary commands passed via command-line arguments (e.g., `maxibridge backend -- <command> [args...]`). This is an extreme security risk (G204 identified) as it allows the execution of any binary on the host if an attacker gains control over these arguments, even indirectly. While `setCaps` and `chroot` (on Linux/Darwin) are used to attempt sandboxing, fully securing arbitrary command execution is exceptionally difficult. The `cmd_others.go` build tag does not enable `chroot`, leaving non-Linux/Darwin systems even more exposed. Input validation and policy enforcement via `policer` exist at a higher level, but do not mitigate the underlying risk of spawning unsandboxed processes. The `pkgs/scan/sbom.go` uses `os.ReadFile` (G304 flagged) to load SBOMs, which could be vulnerable to path traversal if the SBOM file path is user-controlled. Hardcoded secrets are not evident; credentials are managed through environment variables or flags.

Similar Servers

Stats

Interest Score0
Security Score3
Cost ClassMedium
Avg Tokens250
Stars0
Forks0
Last Update2025-12-03

Tags

MCP GatewayDynamic BackendPolicingAPI ProxyGoWebSocketSSE