Synapse R MCP server
{
"mcpServers": {
"dinglebear-synapse-r": {
"command": "npx",
"args": [
"-y",
"synapse-rmcp@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}{
"mcpServers": {
"dinglebear-synapse-r": {
"command": "npx",
"args": [
"-y",
"synapse-rmcp@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}{
"mcpServers": {
"dinglebear-synapse-r": {
"command": "npx",
"args": [
"-y",
"synapse-rmcp@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}{
"servers": {
"dinglebear-synapse-r": {
"command": "npx",
"args": [
"-y",
"synapse-rmcp@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "${input:synapse_mcp_token}",
"SYNAPSE_MCP_PUBLIC_URL": "${input:synapse_mcp_public_url}"
}
}
},
"inputs": [
{
"id": "synapse_mcp_token",
"type": "promptString",
"description": "Synapse mcp token",
"password": true
},
{
"id": "synapse_mcp_public_url",
"type": "promptString",
"description": "Synapse mcp public url",
"password": true
}
]
}{
"mcpServers": {
"dinglebear-synapse-r": {
"command": "npx",
"args": [
"-y",
"synapse-rmcp@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y synapse-rmcpversion 0.5.4
What it does
Synapse R is a Rust MCP server for managing Docker containers, host inspection, SSH operations, file transfers, ZFS storage, and log retrieval. It exposes two MCP tools (flux and scout) with full CLI parity, designed for operators and AI agents that need structured access to infrastructure without arbitrary shell execution.
- Inspect and manage Docker containers and Compose projects across local and remote hosts through MCP or CLI commands.
- Perform safe file operations including bounded file reads, transfers between hosts, and allowlisted command execution with confirmation policies.
- Query host metrics, SSH-connected systems, ZFS storage state, and application logs through a read-only scout interface.
Tools this server exposes
| Tool | Does |
|---|---|
| flux | Manages Docker daemon, containers, Compose projects, and host inspection operations. |
| scout | Handles SSH/local host inspection, safe file reads, allowlisted command execution, file transfers, ZFS introspection, and log retrieval. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.