mcp-impresario
Allows executing commands, reading/writing files, and listing directories on DigitalOcean droplets via SSH.
Allows executing commands, reading/writing files, and listing directories on Hetzner cloud servers via SSH.
Allows executing commands, reading/writing files, and listing directories on a Raspberry Pi via SSH.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Impresario
MCP server for Claude Code to execute commands on any remote server over SSH.
Works with any SSH server you control. A managed sandbox service with batteries-included environments is coming soon.
Installation
npm install -g mcp-impresarioThis installs:
mcp-impresario- MCP server for Claude Codemcp-impresario-test- Connection tester
For other agents (Aider, Codex, Goose, Gemini), use the Impresario CLI (Go binary).
From Source
git clone https://github.com/Pharbi/mcp-impresario
cd mcp-impresario
npm install
npm run buildRelated MCP server: mcp-ssh-tool
Configuration
Add to your Claude Code MCP settings (~/.claude.json or project .claude.json):
{
"mcpServers": {
"remote": {
"type": "stdio",
"command": "mcp-impresario",
"env": {
"IMPRESARIO_HOST": "your-server.com",
"IMPRESARIO_PORT": "22",
"IMPRESARIO_USER": "ubuntu",
"IMPRESARIO_KEY": "/path/to/your/key"
}
}
}
}If running from source, use the compiled path:
{
"mcpServers": {
"remote": {
"type": "stdio",
"command": "node",
"args": ["/path/to/mcp-impresario/dist/index.js"],
"env": {
"IMPRESARIO_HOST": "your-server.com",
"IMPRESARIO_USER": "ubuntu",
"IMPRESARIO_KEY": "/path/to/your/key"
}
}
}
}Environment Variables
Variable | Default | Description |
|
| Hostname or IP of remote server |
|
| SSH port |
|
| SSH username |
| (none) | Path to SSH private key (optional if using ssh-agent) |
| (none) | Path to a custom known_hosts file (see below) |
|
| Set to |
Host Key Management
By default, Impresario uses your system's known_hosts file with strict host key checking.
For ephemeral VPS instances that you spin up and tear down frequently, use a dedicated known_hosts file to avoid polluting your main ~/.ssh/known_hosts:
{
"mcpServers": {
"remote": {
"type": "stdio",
"command": "mcp-impresario",
"env": {
"IMPRESARIO_HOST": "your-server.com",
"IMPRESARIO_USER": "ubuntu",
"IMPRESARIO_KEY": "/path/to/your/key",
"IMPRESARIO_KNOWN_HOSTS": "~/.ssh/impresario_known_hosts"
}
}
}
}When using a custom known_hosts file:
New host keys are automatically accepted and saved
Changed host keys are rejected (MITM protection)
Your system known_hosts remains untouched
Test Connection
export IMPRESARIO_HOST=your-server.com
mcp-impresario-testAvailable Tools
Once configured, Claude Code gains these tools:
Tool | Description |
| Execute any command on the remote server |
| Read a file from the remote server |
| Write a file to the remote server |
| List directory contents |
| Show current connection details |
Usage Examples
After restarting Claude Code, you can ask:
"Run
git clone https://github.com/user/repoon the remote server""Create a Python script on the remote and execute it"
"Check what's in the home directory on the remote"
"Read the package.json from the remote project"
Works with Any Server
This MCP server works with any SSH-accessible machine:
Your own VPS (DigitalOcean, Linode, Hetzner)
Cloud instances (EC2, GCP, Azure)
Home servers or Raspberry Pi
Requirements: SSH server running, key authentication configured.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Termalin's hosted MCP server. Claude, ChatGPT or any MCP client runs commands, moves files over SFTP, queries databases and reads server metrics and monitoring alerts on your servers, keylessly through Termalin Connectors: no SSH key is handed over and no inbound port is opened. Per-host command policy and an audit log. Needs a termal.in Pro or Team account (new accounts start with a 14-day Pro trial).
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn SSH MCP server that enables users to connect to and manage remote servers directly from Claude Code. It provides tools to execute commands, monitor connection status, and dynamically manage server configurations through natural language.106MIT
- AlicenseAqualityAmaintenanceSSH automation MCP server that enables Claude and ChatGPT to execute commands, manage files, install packages, and control services on remote servers over SSH — supporting password, key, and agent authentication.331,267 npm4MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server enabling Claude to execute commands on multiple remote servers via SSH and transfer large files (40GB+) with resume support via SFTP.10 npm17MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that allows Claude Desktop to remotely control Claude Code instances for executing commands and managing files.56 npmGPL 3.0