Sidecar MCP Server
by lsequeiraaio.github.lsequeiraa/mcp-sidecarv0.3.2
Cross-platform MCP server for managing long-lived background processes from any MCP client
context tax
queued
security
queued
cold start
queued
freshness
Slowing4mo ago
Install Sidecar MCP server
Install in Claude Code
claude mcp add sidecar-lsequeiraa -- npx -y mcp-sidecarInstall in Cursor
{
"mcpServers": {
"sidecar-lsequeiraa": {
"command": "npx",
"args": [
"-y",
"mcp-sidecar"
]
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"sidecar-lsequeiraa": {
"command": "npx",
"args": [
"-y",
"mcp-sidecar"
]
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"sidecar-lsequeiraa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-sidecar"
]
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"sidecar-lsequeiraa": {
"command": "npx",
"args": [
"-y",
"mcp-sidecar"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| SIDECAR_MAX_PROCESSES | — | — | Maximum number of concurrent managed processes (default: 10) |
| SIDECAR_BUFFER_SIZE | — | — | Output buffer size per stream in bytes (default: 1048576) |
| SIDECAR_KILL_TIMEOUT | — | — | Milliseconds to wait between graceful and forced termination (default: 5000) |
| SIDECAR_CLEANUP_AFTER | — | — | Seconds before exited processes are auto-removed. 0 disables cleanup (default: 1800) |
| SIDECAR_MAX_OUTPUT_SIZE | — | — | Global cap on bytes returned by the output tool. 0 means unlimited (default: 0) |
| SIDECAR_ALLOWED_EXECUTABLES | — | — | Comma-separated allowlist of executable names. When set, enables security mode with direct exec (no shell). Unset means security disabled. |
| SIDECAR_BLOCKED_PATTERNS | — | — | Comma-separated regex patterns to reject in commands. Only applies when security is enabled. |
| SIDECAR_AUDIT_LOG | — | — | Audit log destination. 'true' writes to cwd, 'temp' writes to OS temp dir, or a directory path. Unset disables audit logging. |
Freshness
Slowing — last maintenance signal 4mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-06-02 · 4mo ago · GitHub
Latest release
2026-06-02 · 4mo ago · GitHub · v0.3.2
Package published
no data · npm/PyPI
Registry entry updated
2026-06-02 · 4mo ago · official registry · v0.3.2
FAQ
›How do I install the Sidecar MCP server in Claude Code?
Run: claude mcp add sidecar-lsequeiraa -- npx -y mcp-sidecar. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Sidecar require an API key?
No required environment variables are declared in its published metadata.
›Can I use Sidecar as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Sidecar in the official MCP registry?
Yes, as io.github.lsequeiraa/mcp-sidecar.