{"id":36833076,"url":"https://github.com/acuvity/minibridge","last_synced_at":"2026-01-21T20:03:01.837Z","repository":{"id":287087892,"uuid":"959488474","full_name":"acuvity/minibridge","owner":"acuvity","description":"Make your MCP servers secure and production ready","archived":false,"fork":false,"pushed_at":"2026-01-07T23:20:51.000Z","size":612,"stargazers_count":54,"open_issues_count":1,"forks_count":11,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-01-12T19:42:58.247Z","etag":null,"topics":["acuvity","mcp","mcp-server","modelcontextprotocol","mtls","security"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/acuvity.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-02T21:39:58.000Z","updated_at":"2026-01-07T23:20:55.000Z","dependencies_parsed_at":"2025-04-09T22:38:27.233Z","dependency_job_id":"f952326f-a772-47ba-ab6c-62f221df4139","html_url":"https://github.com/acuvity/minibridge","commit_stats":null,"previous_names":["acuvity/minibridge"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/acuvity/minibridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acuvity%2Fminibridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acuvity%2Fminibridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acuvity%2Fminibridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acuvity%2Fminibridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acuvity","download_url":"https://codeload.github.com/acuvity/minibridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acuvity%2Fminibridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28641293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T18:04:35.752Z","status":"ssl_error","status_checked_at":"2026-01-21T18:03:55.054Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acuvity","mcp","mcp-server","modelcontextprotocol","mtls","security"],"created_at":"2026-01-12T14:16:32.223Z","updated_at":"2026-01-21T20:03:01.816Z","avatar_url":"https://github.com/acuvity.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Minibridge\n\n[![Build](https://github.com/acuvity/minibridge/actions/workflows/build.yaml/badge.svg?branch=main)](https://github.com/acuvity/minibridge/actions/workflows/build.yaml)\n[![Go Report Card](https://goreportcard.com/badge/github.com/acuvity/minibridge?cache)](https://goreportcard.com/report/github.com/acuvity/minibridge)\n[![GoDoc](https://pkg.go.dev/badge/github.com/acuvity/minibridge.svg)](https://pkg.go.dev/github.com/acuvity/minibridge)\n[![DockerHub](https://img.shields.io/badge/containers-dockerhub-blue.svg)](https://hub.docker.com/u/acuvity?page=1\u0026search=mcp-server)\n\nMinibridge serves as a backend-to-frontend bridge, streamlining and securing\ncommunication between Agents and MCP servers. It safely exposes [MCP\nservers](https://modelcontextprotocol.io) to the internet and can optionally\nintegrate with generic policing services — known as Policers — for agent\nauthentication, content analysis, and transformation. Policers can be\nimplemented remotely via HTTP or locally using [OPA\nRego](https://www.openpolicyagent.org/docs/latest/policy-reference/) policies.\n\nMinibridge can help ensure the integrity of MCP servers through\nSBOM (Software Bill of Materials) generation and real-time validation.\n\nAdditionally, Minibridge supports [OTEL](https://opentelemetry.io/) and can\nreport/rettach spans from classical OTEL headers, as well as directly from the\nMCP call, as inserted by certain tool like [Open\nInference](https://arize-ai.github.io/openinference).\n\n![arch-overview](assets/imgs/mb-arch-overview.png)\n\n- **Minibridge Frontend**: The Client connects to the Frontend part of Minibridge.\n- **Minibridge Backend**: The Frontend connects to the Backend which wraps the MCP server.\n- **Minibridge Policer**: The Policer runs in the Backend and can optionally take decision on the input and output based on some policies (locally with Rego or remotely using HTTPs)\n\n\u003e [!TIP]\n\u003e Conveniently, Minibridge can be started in an \"all-in-one\" (AIO) mode to act as a single process.\n\n## Why using Minibridge ?\n\nMinibridge covers the following:\n\n- **Secure Transport**: Use TLS with optionally, client certificate validation\n- **Integrity**: Ensure the MCP server can not mutate tools, templates, etc. during the execution\n- **User Authentication**: Transport the user information to the Policer\n- **Monitoring**: Expose prometheus metrics\n- **Telemetry**: Report traces and spans using Opentelemetry\n\n## Installation\n\nMinibridge can be installed from various places:\n\n### Homebrew\n\nOn macOS, you can use Homebrew\n\n```console\nbrew tap acuvity/tap\nbrew install minibridge\n```\n\n### AUR\n\nOn Arch based Linux distributions, you can run:\n\n```console\nyay -S minibridge\n```\n\nAlternatively, to get the latest version from the main branch:\n\n```console\nyay -S minibridge-git\n```\n\n### Go\n\nIf you have the Go toolchain install:\n\n```console\ngo install go.acuvity.ai/minibridge@latest\n```\n\nAlternatively, to get the latest version from the main branch:\n\n```console\ngo install go.acuvity.ai/minibridge@main\n```\n\n### Manually\n\nYou can easily grab a binary version for your platform from the [release\npage](https://github.com/acuvity/minibridge/releases/tag/v0.6.2).\n\n\n## Features comparisons\n\n| 🚀 **Feature**                 | 🔹 **MCP**  | 🔸 **Minibridge** | 📦 **ARC (Acuvity Containers)** |\n| ------------------------------ | ----------- | ----------------- | ------------------------------- |\n| 🌐 Remote Access               | ⚠️          | ✅                | ✅                              |\n| 🔒 TLS Support                 | ❌          | ✅                | ✅                              |\n| 📃 Tool integrity check        | ❌          | ✅                | ✅                              |\n| 📊 Visualization and Tracing   | ❌          | ✅                | ✅                              |\n| 🛡️ Isolation                   | ❌          | ⚠️                | ✅                              |\n| 🔐 Security Policy Management  | ❌          | 👤                | ⚠️                              |\n| 🕵️ Secrets Redaction           | ❌          | 👤                | ⚠️                              |\n| 🔑 Authorization Controls      | ❌          | 👤                | 👤                              |\n| 🧑‍💻 PII Detection and Redaction | ❌          | 👤                | 👤                              |\n| 📌 Version Pinning             | ❌          | ❌                | ✅                              |\n\n✅ _Included_ | ⚠️ _Partial/Basic Support_ | 👤 _Custom User Implementation_ | ❌ _Not Supported_\n\n## Example: Configuring Minibridge in your MCP Client\n\nSuppose your client configuration originally specifies an MCP server like this:\n\n```json\n{\n  \"mcpServers\": {\n    \"fetch\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-fetch\"]\n    }\n  }\n}\n```\n\nTo route requests through Minibridge (enabling SBOM checks, policy enforcement, etc.), update the entry:\n\n```json\n{\n  \"mcpServers\": {\n    \"fetch\": {\n      \"command\": \"minibridge\",\n      \"args\": [\"aio\", \"--\", \"uvx\", \"mcp-server-fetch\"]\n    }\n  }\n}\n```\n\n- **`minibridge aio`**: Invokes Minibridge in “all-in-one” mode, wrapping the downstream tool.\n- **`uvx mcp-server-fetch`**: The original MCP server command, now executed inside Minibridge.\n\n\u003e [!TIP]\n\u003e The location of the configuration files depends on your Client. For example, if you use Claude Desktop, configuration files are located:\n\u003e\n\u003e - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\u003e - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\u003e\n\u003e See the official [MCP QuickStart for Claude Desktop Users](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) documentation.\n\n\u003e [!IMPORTANT]\n\u003e Your client must be able to resolve the path of the binary.\n\u003e If you see an error like `MCP fetch: spawn minibridge ENOENT`, set the `command` parameter above to the full path of minibridge (`which minibridge` will give you the full path).\n\n## Documentation\n\nCheck out the complete [documentation](https://github.com/acuvity/minibridge/wiki) from the wiki pages.\n\n## Contribute\n\nWe are excited to welcome contributions from everyone! 🎉 Whether you're fixing bugs, enhancing features, improving documentation, or proposing entirely new ideas, your involvement helps strengthen the project and benefits the entire community.\n\nYou do not need to sign a Contributor License Agreement (CLA) — just open a pull request and let's collaborate!\n\n## Join us\n\n- [Discord](https://discord.gg/BkU7fBkrNk)\n- [LinkedIn](https://www.linkedin.com/company/acuvity)\n- [Bluesky](https://bsky.app/profile/acuvity.bsky.social)\n- [Docker](https://hub.docker.com/u/acuvity)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facuvity%2Fminibridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facuvity%2Fminibridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facuvity%2Fminibridge/lists"}