The MCP Devcontainers is a Model Context Protocol (MCP) server that provides a simple integration with the devcontainers cli.
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.
No other dependencies are required to use the MCP Devcontainers server.
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"
]
}
}
}At the moment, only stdio transport has been implemented.
| 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. |
Released under the MIT License. See the LICENSE file for further details.