Claude Remote Mcp Agent Bridge
БесплатноНе проверенStateless HTTP service on the agent host that drives the herdr CLI
Описание
Stateless HTTP service on the agent host that drives the herdr CLI
README
CI CodeQL License: MIT Python 3.11+
Voice-driven remote orchestration for Claude Code agents. Manage and supervise AI coding agents from anywhere using natural language.
Components
How the layers fit together, where state lives and the trust boundaries: ARCHITECTURE.md. Each component has its own README with system requirements, configuration, deployment and tests.
| Directory | Runs on | Role |
|---|---|---|
| mcp-gateway/ | an always-on host: a small home server, a VPS, or the agent host itself (Linux, macOS; the setup script needs Debian-based Linux with systemd) | MCP server exposed to claude.ai through a Cloudflare Tunnel; signs the connector in with OAuth (a passphrase) and forwards tool calls to agent-bridge. Includes a setup script. |
| agent-bridge/ | the machine where herdr and Claude Code run (macOS, Linux or Windows) | Narrow LAN-only HTTP API translating requests into herdr CLI calls; keeps only its id and its gateway. Enrolls itself with the gateway. Runs as a launchd or systemd user service, or a Windows scheduled task. |
You need:
- herdr 0.8.0+ and Claude Code on each agent host;
- uv on each agent host (the gateway's setup script installs it on the gateway host);
- an agent host that stays awake and logged in while you use it (see Keeping the agent host available);
- a Cloudflare account (the Free plan is fine) with a domain whose DNS is on Cloudflare;
- a Claude plan with custom connectors.
The gateway and the agent host can be one machine.
Setup order
- Cloudflare: add your domain to Cloudflare if it isn't there yet (its DNS must be
managed by Cloudflare), and pick a subdomain for the connector, e.g.
mcp.example.com. Nothing else to create by hand: the setup script in step 2 makes the tunnel and the DNS record. - Gateway host: run mcp-gateway/deploy/setup.sh
with that subdomain. On the first run it prints a Cloudflare login URL: open it in
any browser and pick your domain. It then sets up the service and the
Cloudflare Tunnel, prints the sign-in
passphrase, and prints an enrollment string for the agent hosts, good for 30 minutes
(
sudo mcp-gateway enrollprints a new one). - Agent hosts: on a Mac, run agent-bridge/deploy/macos/setup.sh and paste that string when asked; it installs the service and enrolls it. On Linux, agent-bridge/deploy/linux/setup.sh does the same with a systemd user service. On Windows, run powershell -ExecutionPolicy Bypass -File agent-bridge\deploy\windows\setup.ps1 and paste that string when asked; it installs a logon task, adds a firewall rule for the port (Private networks only) and enrolls it. Or, without a setup script, start agent-bridge, then enroll it with that string.
- claude.ai: add the custom connector by its URL and sign in with that passphrase.
If you have more than one Claude subscription, e.g. a work and a personal one, agents can start on the right one for each project folder: see Claude accounts.
Agents only start in folders Claude Code trusts. agent-bridge can mark them trusted in a
separate Claude config: the macOS and Linux setup scripts ask for it, and on Windows pass
-ClaudeConfigDir and -TrustRoot. Log in to that config once when the script says so.
See Folder trust.
Development
uv workspace; each component is its own package.
uv sync --all-packages
uv run --package claude-remote-mcp-agent-bridge pytest agent-bridge
uv run --package mcp-gateway pytest mcp-gateway
uv run pytest # both packages plus tests/ (deploy scripts, enrollment end to end)
Releasing agent-bridge
agent-bridge is published to PyPI as claude-remote-mcp-agent-bridge; its command is
agent-bridge. To release:
- Set the version, e.g.
uv version --package claude-remote-mcp-agent-bridge 0.2.0, and merge that to main. - Tag that commit on main and push the tag:
git tag agent-bridge-v0.2.0 && git push origin agent-bridge-v0.2.0. - The release workflow runs CI, checks that the tag is
the package's version, builds it, and waits for approval in the
pypienvironment. Approve it in the run; it then publishes to PyPI and creates the GitHub Release.
License
Установка Claude Remote Mcp Agent Bridge
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/placheckij/claude-remote-mcpFAQ
Claude Remote Mcp Agent Bridge MCP бесплатный?
Да, Claude Remote Mcp Agent Bridge MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Claude Remote Mcp Agent Bridge?
Нет, Claude Remote Mcp Agent Bridge работает без API-ключей и переменных окружения.
Claude Remote Mcp Agent Bridge — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Claude Remote Mcp Agent Bridge в Claude Desktop, Claude Code или Cursor?
Открой Claude Remote Mcp Agent Bridge на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare Claude Remote Mcp Agent Bridge with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
