What is Mcp Devcontainers

mcp-devcontainers is a Model Context Protocol (MCP) server designed for seamless integration with the devcontainers CLI, enabling developers to manage and build development containers efficiently.

Use cases

Use cases include initializing development environments for web applications, running automated tests in isolated containers, and executing setup scripts within a devcontainer for consistent development setups.

How to use

To use mcp-devcontainers, ensure Docker is installed and running. Configure the MCP server in your client (e.g., Claude Desktop) using the provided JSON configuration, and utilize commands like ‘devcontainer_up’ to start your development environment.

Key features

Key features include easy integration with devcontainers CLI, support for starting and managing devcontainer environments, executing user-defined commands, and logging output for better tracking.

Where to use

mcp-devcontainers is ideal for software development environments, particularly in projects that utilize containerization for development, testing, and deployment.

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.