Runner MCP
mcpopen · packageio.github.Blacksp1d3r/runner-mcp · v0.1.3
Self-hosted MCP for controlled AI development and staging without a general-purpose remote shell.
run it
on your own machines, one way per deploy methodgenerated from the record, not tested yet
A package that serves HTTP itself; the port comes from its URL template.
#!/usr/bin/env bash # runner (io.github.Blacksp1d3r/runner-mcp), recipe baremetal (generated). # Generated by Hub for toolset "my-agent"; started by mcp-my-agent-runner.service. set -euo pipefail export HOST=127.0.0.1 PORT=8101 exec uvx aifordable-runner-mcp==0.1.3 [Unit] Description=MCP server runner (toolset my-agent), generated by Hub After=network-online.target Wants=network-online.target [Service] Type=simple User=mcp Group=mcp EnvironmentFile=/etc/mcp/my-agent.env Environment=HOME=/var/lib/mcp/runner WorkingDirectory=/var/lib/mcp/runner ExecStart=/opt/mcp/my-agent/bin/runner.sh Restart=on-failure RestartSec=5 NoNewPrivileges=true ProtectSystem=strict ProtectHome=true PrivateTmp=true ReadWritePaths=/var/lib/mcp/runner [Install] WantedBy=multi-user.target
connect to it
copy what your client needs{
"mcpServers": {
"runner": {
"command": "CHANGE_ME",
"args": []
}
}
}
#!/usr/bin/env bash # Registers every server with Claude Code (run once; `claude mcp list` to check). set -euo pipefail set -a; [ -f .env ] && source .env; set +a claude mcp add runner -- CHANGE_ME
{
"mcpServers": {
"runner": {
"command": "CHANGE_ME",
"args": []
}
}
}
{
"servers": {
"runner": {
"type": "stdio",
"command": "CHANGE_ME",
"args": []
}
}
}
name: my-agent target: local servers: - hub: io.github.Blacksp1d3r/runner-mcp
- not probed yet: tools unpinned, ingest lists them
- a package that serves HTTP itself: pick a self-hosted target, not 'local'
tools
Probe result: faileddocker: the container exited: ,service-log,database-config,retention,database,migration-config,deployment-config,adapter,approval,autostart,agent-bus-worker,completion-notifier,completion-watcher,agent-bus,github-mailbox,github-watcher,serve} ... runner-mcp: error: the following arguments are required: command; baremetal: the container exited: ,service-log,database-config,retention,database,migration-config,deployment-config,adapter,approval,autostart,agent-bus-worker,completion-notifier,comple…
runs · 1
the latest tests of this entry by the hub and its workers, newest first| date | worker | method | status | sandbox | reason |
|---|---|---|---|---|---|
| 2026-10-16 15:55 | local-mac-vm | docker | failed | gvisor | docker: the container exited: ,service-log,database-config,retention,database,migration-config,deployment-config,adapter,approval,autostart,agent-bus-worker,com… |