exeora MCP server
Commit Nov 1, 2026Connect AI agents to your local development environment or cloud instances via a secure outbound WebSocket connection.
Also known as leynier/exeora
- Stars
- 7
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 1, 2026
- License
- AGPL-3.0
What is exeora MCP?
exeora connects AI agents to your local development environment or cloud instances via a secure outbound WebSocket connection.
Summary generated from the project's README
About exeora MCP server
Connecting AI agents to your local development environment or cloud instances is what Exeora enables through a secure outbound WebSocket connection. Developers can turn a laptop, a Raspberry Pi, a VM, or an Exeora Cloud instance into a single MCP URL that clients like Claude, ChatGPT, Cursor, and VS Code can use to read, edit, and run code. This setup eliminates the need to open inbound ports, upload source code to sandboxes, or configure complex tunnels.
Users install the CLI to register specific directories as projects. The system provides a variety of tools including read_file, edit_file, run_command, and apply_patch. Security is managed through OAuth 2.1 and per-project tokens, ensuring that an agent's access is confined to registered filesystem roots. You can also set command rules, such as read-only modes or approval requirements, to control how the agent interacts with your operating system permissions.
What you can do with it
- 1Remote code editingAn AI agent can directly modify files in a local repository without the developer needing to upload the code to a cloud sandbox.
- 2Secure command executionDevelopers can allow AI agents to run terminal commands within a controlled environment using specific operating system permissions.
- 3Cloud-based development without local hardwareYou can host a project on Exeora Cloud so an AI agent can work on a repository even when your own machine is turned off.
- 4Proxying existing MCP serversYou can expose tools from other MCP servers running on your machine through a single Exeora endpoint.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableleynier/exeora is public and reachablegithub.com/leynier/exeora ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-01github.com/leynier/exeora ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubExeora turns a project on a server, a VM, a build box, a Raspberry Pi, the laptop in front of you, or Exeora Cloud into one MCP URL. Claude, ChatGPT, Cursor, VS Code, Copilot and every other MCP client can then read, edit and run it right there, under rules you set.
No port to open. No source code to upload. No tunnel to wire up. Free for 10 machines and 2 Cloud instances.
curl -fsSL https://exeora.dev/linux/install.sh | sh
exeora connect
exeora project add the-project-you-want-to-serve
connect signs you in, registers the machine, and keeps the outbound connection open. It does not have to be run from a project directory. exeora project add registers a directory to serve. Point any client at the printed MCP URL and leave connect running.
A project is a repository, and it lives in one or more locations: your machines and Exeora Cloud. One location is the default, where a call that names no workspace lands. Running exeora project add in a checkout whose remote is already a project joins that project as one more location. With GitHub connected in the dashboard, a project can also be added by picking a repository from a list and letting Exeora Cloud hold it, with no machine of yours switched on. See projects, locations and workspaces.
Contents: Why Exeora · How it works · Compare · What you get · Tools · Beyond tool calls · Clients · Install · Plans · Documentation · Contributing
Why Exeora
AI agents are only as useful as the environment they can touch. Today you usually pick one of two bad options:
- Expose the machine - open a port, run a tunnel, hope the URL stays private.
- Upload the code - push the repo into a cloud sandbox that is never quite your machine.
Exeora is the third path. The CLI dials out to a gateway and holds a WebSocket open. Nothing ever dials in. Your files stay on the machine they already live on. Filesystem tools confine access to the project's registered roots. Commands and terminals run with the operating-system permissions of the account running Exeora; use command rules, approvals and a dedicated account or container to restrict that access.
flowchart TD
client["MCP client<br/><small>Claude · ChatGPT · Cursor</small>"]
subgraph cloud["exeora.dev · Cloudflare · or your own gateway"]
gateway["Gateway<br/><small>OAuth 2.1 · policy · audit</small>"]
relay["DeviceRelay"]
end
subgraph machine["your machine · laptop, server, VM, Pi"]
cli["Exeora CLI"]
repo[("your repository")]
end
subgraph instance["Exeora Cloud instance"]
cloudcli["Exeora CLI"]
clone[("a clone of the repository")]
end
client -->|"Streamable HTTP"| gateway
gateway --> relay
cli -.->|"outbound WebSocket only"| relay
cloudcli -.->|"outbound WebSocket only"| relay
relay -->|"tool.call"| cli
relay -->|"tool.call"| cloudcli
cli --> repo
cloudcli --> clone
How it works
- You run the CLI on the machine. It opens an outbound connection to Exeora. No inbound port, no VPN, no ngrok config. Add each directory you want to serve with
exeora project add. - You authorize a client once. OAuth 2.1 with PKCE. Each project can be its own URL and its own token, so blast radius is a fact about the path, not a promise the model is asked to keep.
- The agent works where the code already is - read, search, edit, run commands - under the policy you set. Revoke the machine from the dashboard and the socket closes immediately.
Compare
| Exeora | Tunnel (ngrok, Cloudflare Tunnel, …) | Cloud sandbox | |
|---|---|---|---|
| Where your code lives | The machine you ran it on | The machine you ran it on | A copy on their infrastructure |
| Inbound port | None | None, but a public URL is published | None |
| What is reachable | Project filesystem tools; commands under the executor's OS permissions | Whatever is listening on that port | A full shell in the copy |
| Per-project isolation | Separate OAuth resource and token | You build it | One sandbox per project |
| Authentication | OAuth 2.1, built in | Whatever your service does | The vendor's account |
| Your real toolchain and state | Yes | Yes | Reinstalled, never quite the same |
| Setup | Install, log in, connect | Run the tunnel, then secure it | Push your code |
What you get
- No inbound network path - outbound HTTPS is the only requirement. Home routers, corporate proxies and cloud VMs with no public address all work unconfigured.
- Your code stays where you put it - on a machine of yours, Exeora routes tool calls and does not store the repository. Exeora Cloud holds a clone only of a project you put there.
- A token per endpoint - a token minted for one project is refused at another. Ownership is checked in the database too.
- Filesystem paths stay in registered roots - filesystem tools reject
..and outward symlinks. Commands, terminals and configured upstream MCP servers retain their operating-system permissions. - Modes and command rules - read only, allow list, deny list, per-tool restrictions. Shell metacharacters are refused whenever a list is in force.
- Confirm before it runs - optional approval for edits and commands, in the conversation (MCP 2026-07-28) or on the terminal and dashboard.
- An audit log you can show someone - which tool ran, how it ended, how long it took. Never the arguments, never the output.
- Revoke and it stops - closing a machine kills the live socket that instant, not when a token expires.
- Bring your own client - Streamable HTTP, OAuth 2.1, PKCE, dynamic client registration. No plugin, no fork, no lock-in.
Tools
read_file · list_files · grep · edit_file · write_file · apply_patch · list_git_workspaces · create_workspace · attach_workspace · detach_workspace · remove_workspace · run_command · start_command · get_command_output · send_command_input · kill_command · list_skills
On the account URL, list_projects shows the available targets. When it returns more than one, every executor tool call names its project, so concurrent conversations do not move each other.
Both URLs also carry get_agent_prompt, which reaches no machine: it hands back Exeora's own coding-agent instructions, for a client that arrived without any. See the agent prompt.
Full reference: exeora.dev/docs/tools.
Beyond tool calls
Exeora Cloud
A project does not need a machine of yours switched on. Exeora Cloud is one more location a project can live in: an instance Exeora runs, with a clone of the repository, the CLI already connected, your tools installed by a script you write, and gh signed in as you. One instance per workspace; it sleeps a minute after it stops working and wakes on the next call, disk intact. Clients connect with the same URL and the same policy applies.
exeora project add owner/repo --on cloud
See Exeora Cloud.
GitHub
Connect GitHub once and add a project by picking a repository, with no address and no token. Exeora clones, fetches and pushes with tokens that last an hour and reach that one repository. See connecting GitHub.
Source Control, terminal and Chrome
The dashboard shows what an agent changed: diffs, stage, commit, pull and push, and a web terminal on the same workspace, all under the project's policy. Exeora for Chrome puts that same screen in Chrome's side panel, next to the pull request you are reviewing. See Source Control and terminal.
Proxy other MCP servers
Exeora can also start the MCP servers configured on your machine and re-publish their tools through its own MCP endpoint. List them in mcp.json next to Exeora's config.json, in the mcpServers shape other clients use; stdio and Streamable HTTP are supported. Upstream tools appear as mcp__server__tool, keep their schema and result, and follow the project's policy: a tool not marked read only is refused in a read-only project and confirmed where the project asks before changes.
See proxy other MCP servers for configuration, project servers and their trust setting, and limits.
Clients
No client plugin: anything that speaks MCP over Streamable HTTP with OAuth 2.1 connects. Step-by-step setup, checked against each client's own documentation, for:
Claude Code · Claude · ChatGPT · Cursor · VS Code · GitHub Copilot · Devin · Antigravity · Amp · Zed · OpenCode · Grok · Perplexity · Codex, Gemini CLI and Windsurf
To try one by hand, the MCP Inspector works too.
The agent prompt
Claude Code and Cursor arrive knowing how to be a coding agent. claude.ai, ChatGPT and anything you wired up yourself do not, and it shows: they read files to find a symbol, overwrite a file they only half read, and treat a policy refusal as a problem to route around.
So Exeora ships a coding-agent prompt of its own, on four channels, because clients disagree about which they support:
instructionsin the MCP handshake. A short brief, arriving with nobody asking.- The
coding_agentprompt, for clients with an MCP prompt menu. - The
get_agent_prompttool, for everything else, and for a model that decides to read first. exeora prompt, for whatever is not an MCP client at all.
exeora prompt > AGENTS.md # or | pbcopy, or into a system prompt box
exeora prompt --account # the variant for the account URL
It is about Exeora rather than about your codebase, so keep your own AGENTS.md exactly as it is. Read it at exeora.dev/docs/agent-prompt.
Install
The CLI is a single native binary:
# Linux
curl -fsSL https://exeora.dev/linux/install.sh | sh
# macOS
curl -fsSL https://exeora.dev/macos/install.sh | sh
# Windows PowerShell
irm https://exeora.dev/windows/install.ps1 | iex
The installer selects the release for your operating system and CPU, verifies its SHA-256 checksum,
and puts exeora on your PATH. The Linux binary needs glibc 2.31 or newer (Ubuntu 20.04 LTS,
22.04, 24.04, Debian 11 and later, current Fedora releases, and RHEL 9 and later). Later, one command updates it in place:
exeora upgrade
Then add the printed URL to your client, for example:
claude mcp add --transport http exeora <the URL>
Plans
Free while Pro is in development: 10 live machines, 25 projects, 2 Exeora Cloud instances and 24 hours of audit history, with no credit card. See plans and limits.
Documentation
| Get started | Getting started · Connecting a client · Projects, locations and workspaces · Connecting GitHub |
| Use | Tools · The agent prompt · Proxy other MCP servers · Source Control and terminal · Chrome extension |
| Control | What a project allows · Security model · Plans and limits |
| Run | Exeora Cloud · Self-hosting (in this repo) |
| Reference | CLI reference · Troubleshooting |
| This repo | CONTRIBUTING.md · SECURITY.md |
Repository layout
| Path | What it is |
|---|---|
crates/exeora-cli |
Native Rust exeora binary and local tool executor |
crates/exeora-protocol-gen |
Rust types generated from the canonical Zod schemas |
packages/protocol |
Shared tool contract and relay wire format |
packages/design |
Design tokens |
apps/gateway |
Cloudflare Worker (OAuth, MCP, relay, API, static site) |
apps/web |
Landing, docs and dashboard sources |
apps/extension |
Exeora for Chrome, a shell that frames the dashboard's Workspace screen in the side panel |
e2e |
Playwright tests for the landing, docs and dashboard |
Contributing
See CONTRIBUTING.md for local setup, tests and CLI releases.
Issues and pull requests are welcome. For vulnerabilities, email hello@exeora.dev - do not open a public issue.
License
If you modify Exeora and offer it as a network service, you must offer the corresponding source to the users of that service.
exeora MCP questions
Does Exeora require opening ports on my machine?
No, Exeora uses an outbound WebSocket connection so no inbound ports need to be opened.
How does Exeora handle security and permissions?
It uses OAuth 2.1 for authorization and allows you to set command rules, allow lists, and deny lists to restrict agent access.
Can I use Exeora with existing MCP servers?
Yes, Exeora can proxy other MCP servers configured on your machine and re-publish them through its own endpoint.