aniongithub avatar

devcontainer-mcp

aniongithub/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 tools

Public 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

CI Website

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.

devcontainer-mcp local Docker demo

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:


View the full README on GitHub

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

Related Cloud & Infrastructure MCP servers

View all
1ionos-cloud avatarIONOS CLOUD MCP Serverionos-cloud/ionoscloud-mcpInspect and manage IONOS CLOUD infrastructure via MCP. Writes are opt-in and off by default.11stars
2whw23 avatarSearXNG HTTP MCPwhw23/searxng_http_mcpSelf-contained SearXNG metasearch MCP server. One Docker image, 200+ engines, privacy-first.8stars
3mikhae1 avatarKubeviewmikhae1/kubeview-mcpRead-only Model Context Protocol MCP server enabling code-driven AI analysis of Kubernetes clusters.5stars
4jmagar avatarCortex RMCPjmagar/cortexRust MCP server for homelab logs, syslog, Docker logs, FTS search, and AI transcript correlation.4stars
5notharshhaa avatarDevops Mcpnotharshhaa/devops-mcpUnified MCP server for Kubernetes, ArgoCD, Prometheus, PagerDuty, and Loki4stars
6cyntrisec avatarCyntrisec CLI (Historical)cyntrisec/cyntrisec-cliHistorical AWS analysis CLI; not a current Cyntrisec product.3stars