mcp-devcontainers

MCP for devcontainers

6 stars TypeScriptOthers Updated Apr 17, 2026

devcontainersmcp-server

Documentation

mcp-devcontainers

The MCP Devcontainers is a Model Context Protocol (MCP) server that provides a simple integration with the devcontainers cli.

Dependencies

This server requires Docker to be installed and running on your system, as it is used by the devcontainers cli to build and manage development containers.

Docker installation guide

No other dependencies are required to use the MCP Devcontainers server.

Usage

MCP servers are configured differently depending on the client that you are using. For reference, this is how you would configure it using Claude Desktop.

json

{
  "mcpServers": {
    "devcontainers": {
      "command": "npx",
      "args": [
        "-y",
        "@crunchloop/mcp-devcontainers"
      ]
    }
  }
}

MCP Transport

At the moment, only `stdio` transport has been implemented.

Tools

Tool	workspaceFolder	outputFilePath	Command	Description
devcontainer_up	Path to the workspace folder (string, required)	Path to write output logs (string, optional)	N/A	Start or initialize a devcontainer environment in the specified workspace folder.Use this to ensure the devcontainer is running and ready for development tasks.
devcontainer_run_user_commands	Path to the workspace folder (string, required)	Path to write output logs (string, optional)	N/A	Run the user-defined `postCreateCommand` and `postStartCommand` scripts in the devcontainer for the specified workspace folder.Use this to execute setup or initialization commands after the devcontainer starts.
devcontainer_exec	Path to the workspace folder (string, required)	Path to write output logs (string, optional)	Command to execute (string[], required)	Execute an arbitrary shell command inside the devcontainer for the specified workspace folder.Use this to run custom commands or scripts within the devcontainer context.