Synapse MCP server
{
"mcpServers": {
"dinglebear-synapse": {
"command": "npx",
"args": [
"-y",
"@dinglebear/synapse@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}{
"mcpServers": {
"dinglebear-synapse": {
"command": "npx",
"args": [
"-y",
"@dinglebear/synapse@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}{
"mcpServers": {
"dinglebear-synapse": {
"command": "npx",
"args": [
"-y",
"@dinglebear/synapse@latest"
],
"env": {
"SYNAPSE_MCP_TOKEN": "<synapse_mcp_token>",
"SYNAPSE_MCP_PUBLIC_URL": "https://..."
}
}
}
}{
"servers": {
"dinglebear-synapse": {
"command": "npx",
"args": [
"-y",
"@dinglebear/synapse@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": {
"command": "npx",
"args": [
"-y",
"@dinglebear/synapse@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 @dinglebear/synapseversion 1.0.0
What it does
Synapse is a Rust MCP server that exposes Docker, Compose, host, SSH, log, ZFS, and file operations through two tools: `flux` for container and host management, and `scout` for inspection, file access, and remote operations. It is for developers who need programmatic control over local and remote infrastructure via MCP clients or a CLI.
- Query and manage Docker containers and Compose projects on local or remote hosts through MCP tool calls.
- Inspect host information, read files safely, and execute allowlisted commands on multiple hosts via SSH.
- Retrieve logs, perform ZFS operations, and transfer files between systems with confirmation policies for destructive actions.
Tools this server exposes
| Tool | Does |
|---|---|
| flux | Manages Docker infrastructure, containers, Compose projects, and host inspection. |
| scout | Handles SSH/local host inspection, safe file reads, allowlisted command execution, file transfer, 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.