@brycepelletier/docker-app-mcp
v0.1.0
Published
Bounded Docker operations for ephemeral GitHub Actions runners.
Readme
Docker App MCP
Narrow, structured Docker tools for an ephemeral Linux x64 GitHub Actions runner. No arbitrary Docker CLI or shell is exposed.
Tools: docker_status, list_managed_resources, build_runner_image, start_runner, runner_status, runner_logs, and stop_runner.
Every mutable container is correlated as environment-controller-pr-<PR>-<RUN_ID> and protected by both io.brycepelletier.docker-operator.managed=true and a request-ID label. Registration uses a one-time opaque capability issued by github-app-mcp; the credential is exchanged internally and never returned in MCP output.
Use with npx
Configure the MCP server with the published package:
{
"docker-app": {
"type": "stdio",
"command": "npx",
"args": ["--yes", "@brycepelletier/[email protected]"]
}
}For local development, run npm run link, configure the command as
docker-app-mcp, and use npm run unlink when finished. Run
npm run validate before publishing.
