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.

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

MCP Transport

At the moment, only stdio transport has been implemented.

Tools

• devcontainer_up - Start or initialize a devcontainer environment in the specified workspace folder. Use this to ensure the devcontainer is running and ready for development tasks.

  • workspaceFolder: Path to the workspace folder (string, required)
  • outputFilePath: Path to write output logs (string, optional)

• devcontainer_run_user_commands - 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.

  • workspaceFolder: Path to the workspace folder (string, required)
  • outputFilePath: Path to write output logs (string, optional)

• devcontainer_exec - 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.

  • workspaceFolder: Path to the workspace folder (string, required)
  • command: Command to execute (string[], required)
  • outputFilePath: Path to write output logs (string, optional)

License

Released under the MIT License. See the LICENSE file for further details.