FeuSh MCP
by reeenatamc
README.md
# FeuSh MCP
**Let your AI agent work on another computer.** Claude Code, Cursor, Codex, VS Code or any MCP client can run commands, take screenshots and move files on a remote Windows, macOS or Linux machine, using a 9-digit number, a key and the owner's approval.
FeuSh is like AnyDesk for the terminal, made for AI: the person on the other side shares their computer from the [FeuSh app](https://feush.com), you tell your agent what to fix, and they see every command before it runs.
```text
You: The PC at 611 267 918 doesn't print. Key 7KX-42P. Check it and tell me before changing anything.
Agent: exec → Get-Printer, Get-Service Spooler, Get-PrintJob …
The spooler is stopped and there are 14 stuck jobs. Do you want me to restart it?
```
[Website](https://feush.com) · [Docs](https://feush.com/docs) · [Download](https://feush.com) · [Pricing](https://feush.com/pricing) · [Español](README.es.md)
## Install
You need Node.js 18 or later. The first run downloads the official `feu` command from feush.com and checks its signature. If `feu` is already installed, it uses that.
**Claude Code**
```sh
claude mcp add feush -- npx -y feush-mcp
```
**Cursor** (`~/.cursor/mcp.json`), **Claude Desktop** (`claude_desktop_config.json`), **Windsurf** and other clients:
```json
{
"mcpServers": {
"feush": {
"command": "npx",
"args": ["-y", "feush-mcp"]
}
}
}
```
**VS Code** (`.vscode/mcp.json`):
```json
{
"servers": {
"feush": { "type": "stdio", "command": "npx", "args": ["-y", "feush-mcp"] }
}
}
```
**Codex** (`~/.codex/config.toml`):
```toml
[mcp_servers.feush]
command = "npx"
args = ["-y", "feush-mcp"]
```
Without Node.js, install `feu` and use `feu mcp` as the command:
```sh
curl -fsSL https://feush.com/install.sh | sh # macOS and Linux
irm https://feush.com/install.ps1 | iex # Windows (PowerShell)
```
## How it works
1. The person who needs help installs the [FeuSh app](https://feush.com) and taps **Share**. They get a 9-digit number and a key that changes every time.
2. They give you the number and the key. You pass them to your agent in the chat, or put the key in `FEU_PASSWORD` when you start the server so it never goes into the conversation.
3. The first time the agent connects, FeuSh asks the person **«Allow?»**. Nobody gets in without that yes; with no answer in 60 seconds the connection is refused.
4. The agent works. The person sees every command before it runs and can stop everything at any moment. Everything goes to a log on their computer.
## Tools
| Tool | What it does |
|---|---|
| `exec` | Runs a command (PowerShell, cmd, bash or zsh) and returns stdout, stderr and the exit code. Up to 600 s. |
| `screenshot` | Saves a PNG of the other screen. |
| `put` / `get` | Sends or brings one file, up to 1 GiB, checking its SHA-256. |
| `computers` | Lists the computers saved with a name (`feu book add office 611267918`). |
| `disconnect` | Closes the session with a computer. |
| `guide` | Short instructions for the agent: safe recipes for Windows, macOS and Linux, and the error codes. |
The session stays open: the key and the approval happen once, not on every command.
## Security
- **Approval on the other side.** Every new connection needs the person's yes, and they can stop it at any time.
- **End-to-end encryption.** Computers connect directly when the network allows; otherwise traffic goes through a relay that cannot read it.
- **Brute-force lockout.** The key changes with every share; after 20 wrong keys FeuSh refuses connections for 10 minutes.
- **Signed binaries.** This package downloads `feu` only over HTTPS and only runs it if the minisign signature matches the FeuSh release key and names the right file for your platform.
- **Local log.** The log stays on the shared computer (`feu log`). Command output is never stored.
## Plans
The Free plan needs no account, key or card. It is for helping family and friends: up to 5 different computers a month, one open at a time, and your AI on one computer. [Pro](https://feush.com/pricing) ($12 per person a month, or $10 paying yearly) is for technicians and teams who charge for helping: unlimited computers, 10 open at a time and your AI on several at once. Getting help is always free; only the person who helps pays.
## Compared with
- **AnyDesk / TeamViewer**: made for people looking at a screen. FeuSh gives an agent a real terminal with exit codes and files, and keeps the human approval.
- **SSH**: needs open ports, accounts and keys on the other side. FeuSh works behind NAT and firewalls with only a number and a one-time key, and the owner approves.
- **Remote shell MCP servers**: most of them assume you already have SSH or a server. FeuSh includes the connection, the approval and the app for the person you are helping.
## About this repository
This repository holds the `npx feush-mcp` launcher (MIT license) and the setup docs. FeuSh itself (the app and `feu`) is downloaded from [feush.com](https://feush.com). Questions: hello@feush.com.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues