
devcontainer-mcp
Gives AI agents the ability to spin up, manage, and execute commands inside dev containers without contaminating your local environment. Exposes 46 MCP tools across three backends: local Docker via the devcontainer CLI, multi-cloud environments through DevPod, and GitHub Codespaces. The auth broker handles GitHub, AWS, Azure, GCP, and Kubernetes credentials without exposing raw tokens to the agent. You get lifecycle operations (up, stop, delete, build), SSH command execution, file operations (read, write, edit, list), and container introspection. Useful when you want your agent to build, test, or deploy in isolated, reproducible environments defined by devcontainer.json specs, whether that's on your machine, a cloud VM, or Codespaces.
- GitHub stars
- 28
- tools
- 46
- transport
- STDIO
- last updated
- Sep 8, 2026
Tools
46 toolsPublic tool metadata for what this MCP can expose to an agent.
auth_statusCheck auth for a provider — returns handles, accounts, scopes
Check auth for a provider — returns handles, accounts, scopes
No parameter schema in public metadata yet.
auth_loginInitiate login or refresh scopes — browser + device code flow
Initiate login or refresh scopes — browser + device code flow
No parameter schema in public metadata yet.
auth_selectSwitch the active account for a provider
Switch the active account for a provider
No parameter schema in public metadata yet.
auth_logoutRevoke credentials for an account
Revoke credentials for an account
No parameter schema in public metadata yet.
devpod_upCreate and start a workspace from a git URL, local path, or image
Create and start a workspace from a git URL, local path, or image
No parameter schema in public metadata yet.
devpod_stopStop a running workspace
Stop a running workspace
No parameter schema in public metadata yet.
devpod_deleteDelete a workspace and its resources
Delete a workspace and its resources
No parameter schema in public metadata yet.
devpod_buildBuild a workspace image without starting it
Build a workspace image without starting it
No parameter schema in public metadata yet.
devpod_statusGet workspace state (`Running`, `Stopped`, `Busy`, `NotFound`)
Get workspace state (`Running`, `Stopped`, `Busy`, `NotFound`)
No parameter schema in public metadata yet.
devpod_listList all workspaces with IDs, sources, providers, and status
List all workspaces with IDs, sources, providers, and status
No parameter schema in public metadata yet.
devpod_sshExecute a command inside a workspace via SSH
Execute a command inside a workspace via SSH
No parameter schema in public metadata yet.
devpod_logsGet workspace logs
Get workspace logs
No parameter schema in public metadata yet.
devpod_provider_listList all configured providers
List all configured providers
No parameter schema in public metadata yet.
devpod_provider_addAdd a new provider
Add a new provider
No parameter schema in public metadata yet.
devpod_provider_deleteRemove a provider
Remove a provider
No parameter schema in public metadata yet.
devpod_context_listList all contexts
List all contexts
No parameter schema in public metadata yet.
devpod_context_useSwitch to a different context
Switch to a different context
No parameter schema in public metadata yet.
devpod_container_inspectDocker inspect — labels, ports, mounts, state
Docker inspect — labels, ports, mounts, state
No parameter schema in public metadata yet.
devpod_container_logsStream container logs via Docker API
Stream container logs via Docker API
No parameter schema in public metadata yet.
devpod_file_readRead file content with optional line range
Read file content with optional line range
No parameter schema in public metadata yet.
devpod_file_writeCreate or overwrite a file (auto-creates parent dirs)
Create or overwrite a file (auto-creates parent dirs)
No parameter schema in public metadata yet.
devpod_file_editSurgical string replacement — old_str → new_str
Surgical string replacement — old_str → new_str
No parameter schema in public metadata yet.
devpod_file_listList directory contents (non-hidden, 2 levels deep)
List directory contents (non-hidden, 2 levels deep)
No parameter schema in public metadata yet.
devcontainer_upCreate and start a local dev container
Create and start a local dev container
No parameter schema in public metadata yet.
devcontainer_execExecute a command inside a running dev container
Execute a command inside a running dev container
No parameter schema in public metadata yet.
devcontainer_buildBuild a dev container image
Build a dev container image
No parameter schema in public metadata yet.
devcontainer_read_configRead merged devcontainer configuration as JSON
Read merged devcontainer configuration as JSON
No parameter schema in public metadata yet.
devcontainer_list_configsDiscover all devcontainer.json files in a workspace (single + multi-container)
Discover all devcontainer.json files in a workspace (single + multi-container)
No parameter schema in public metadata yet.
devcontainer_stopStop a dev container (via Docker API)
Stop a dev container (via Docker API)
No parameter schema in public metadata yet.
devcontainer_removeRemove a dev container and its resources
Remove a dev container and its resources
No parameter schema in public metadata yet.
devcontainer_statusGet dev container state by workspace folder
Get dev container state by workspace folder
No parameter schema in public metadata yet.
devcontainer_file_readRead file content with optional line range
Read file content with optional line range
No parameter schema in public metadata yet.
devcontainer_file_writeCreate or overwrite a file (auto-creates parent dirs)
Create or overwrite a file (auto-creates parent dirs)
No parameter schema in public metadata yet.
devcontainer_file_editSurgical string replacement — old_str → new_str
Surgical string replacement — old_str → new_str
No parameter schema in public metadata yet.
devcontainer_file_listList directory contents (non-hidden, 2 levels deep)
List directory contents (non-hidden, 2 levels deep)
No parameter schema in public metadata yet.
codespaces_createCreate a new codespace for a repository
Create a new codespace for a repository
No parameter schema in public metadata yet.
codespaces_listList your codespaces with state and machine info
List your codespaces with state and machine info
No parameter schema in public metadata yet.
codespaces_sshExecute a command inside a codespace via SSH
Execute a command inside a codespace via SSH
No parameter schema in public metadata yet.
codespaces_stopStop a running codespace
Stop a running codespace
No parameter schema in public metadata yet.
codespaces_deleteDelete a codespace
Delete a codespace
No parameter schema in public metadata yet.
codespaces_viewView detailed codespace info (state, machine, config)
View detailed codespace info (state, machine, config)
No parameter schema in public metadata yet.
codespaces_portsList forwarded ports with visibility and URLs
List forwarded ports with visibility and URLs
No parameter schema in public metadata yet.
codespaces_file_readRead file content with optional line range
Read file content with optional line range
No parameter schema in public metadata yet.
codespaces_file_writeCreate or overwrite a file (auto-creates parent dirs)
Create or overwrite a file (auto-creates parent dirs)
No parameter schema in public metadata yet.
codespaces_file_editSurgical string replacement — old_str → new_str
Surgical string replacement — old_str → new_str
No parameter schema in public metadata yet.
codespaces_file_listList directory contents (non-hidden, 2 levels deep)
List directory contents (non-hidden, 2 levels deep)
No parameter schema in public metadata yet.
Sponsors
Readme
devcontainer-mcp
Give your AI agent its own dev environment — not yours.
devcontainer-mcp is an MCP server that lets AI coding agents create, manage, and work inside dev containers across three backends: local Docker, DevPod, and GitHub Codespaces. The agent builds, tests, and ships code in an isolated container — your laptop stays clean.
Works with GitHub Copilot, Claude, Cursor, opencode, and any MCP-compatible client.
The Problem
When AI agents write code, they need to run it somewhere. Today that means your host machine:
Details
- Repository
- github.com/aniongithub/devcontainer-mcp
- Categories
- Cloud & Infrastructure, Developer Tools
- Package
https://github.com/aniongithub/devcontainer-mcp/releases/download/v0.40/devcontainer-mcp-linux-x64.tar.gz- Transport
- STDIO
- Registry
- MCP registry, active