Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Claude Remote Mcp Gateway

БесплатноНе проверен

Public MCP server that exposes Claude Code session tools and forwards them to agent-bridge

GitHubEmbed

Описание

Public MCP server that exposes Claude Code session tools and forwards them to agent-bridge

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.

Three layers and four trust boundaries. The Claude app reaches mcp-gateway on the gateway host over MCP over HTTPS, through a Cloudflare Tunnel, with an OAuth access token; mcp-gateway keeps clients and token hashes in oauth.json, its agent hosts in bridges.json and the enrollment window in enrollment.json. mcp-gateway reaches agent-bridge on each agent host (macOS, Linux, Windows) over HTTP on the LAN with that host's bearer token, and agent hosts enroll with the gateway over the LAN with the window's secret. Each agent-bridge keeps its id and gateway in state.json, only changes agents under its allowed roots, and drives herdr through the herdr CLI; herdr runs Claude Code sessions, one per pane, each on the Claude account set up for its folder, with ids that name the host, such as mac/w1:p1.

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

  1. 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.
  2. 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 enroll prints a new one).
  3. 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.
  4. 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:

  1. Set the version, e.g. uv version --package claude-remote-mcp-agent-bridge 0.2.0, and merge that to main.
  2. Tag that commit on main and push the tag: git tag agent-bridge-v0.2.0 && git push origin agent-bridge-v0.2.0.
  3. The release workflow runs CI, checks that the tag is the package's version, builds it, and waits for approval in the pypi environment. Approve it in the run; it then publishes to PyPI and creates the GitHub Release.

License

MIT

from github.com/placheckij/claude-remote-mcp

Установка Claude Remote Mcp Gateway

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/placheckij/claude-remote-mcp

FAQ

Claude Remote Mcp Gateway MCP бесплатный?

Да, Claude Remote Mcp Gateway MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Claude Remote Mcp Gateway?

Нет, Claude Remote Mcp Gateway работает без API-ключей и переменных окружения.

Claude Remote Mcp Gateway — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Claude Remote Mcp Gateway в Claude Desktop, Claude Code или Cursor?

Открой Claude Remote Mcp Gateway на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Claude Remote Mcp Gateway with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development