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.
No other dependencies are required to use the MCP Devcontainers server.
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. |
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"
]
}
}
}No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MIT— you can use, modify, and redistribute it under that license's terms.
License
Released under the MIT License. See the LICENSE file for further details.