This is a Model Context Protocol (MCP) server forMicrosoft Dev Box, providing seamless integration between AI agents and Microsoft Dev Box services. This server enables natural language interactions for developer-focused operations like managing Dev Boxes, configurations, and pools.

1. Node.js 18 or newer

2. Azure Resources

   • Azure subscription
   • Dev Center provisioned
   • At least one Dev Center project created
   • Appropriate RBAC permissions on Dev Center resources

3. MCP Client

• Install yourMCP host/client of choice
• Recommended MCP clients include:
  • Visual Studio Code with GitHub Copilot extension
  • Visual Studio 2022 version 17.14 or later

Dev Box MCP Server can be installed on any MCP clients, such as Visual Studio or Visual Studio Code (VS Code). Below are the detailed steps for installing on Visual Studio Code.

For installation steps on Visual Studio, seehere

Click one of these buttons to install the Dev Box MCP Server for VS Code or VS Code Insiders.

Just one click, and you're ready to go! 🎉

For a step-by-step installation, follow one of the following instructions:

1. Add.vscode/mcp.json to your workspace:

{"servers": {"DevBox": {"command":"npx","args": ["-y","@microsoft/devbox-mcp@latest"]        }    }}

2. Alternatively, add to youruser settings.json:

{"mcp": {"servers": {"DevBox": {"command":"npx","args": ["-y","@microsoft/devbox-mcp@latest"]            }        }    }}

3. You can also add Dev Box MCP programmatically using VS Code CLI:

# For VS Codecode --add-mcp'{"name":"DevBox","command":"npx","args":["-y","@microsoft/devbox-mcp@latest"]}'

For detailed MCP installation steps on VS Code, seehere.

If you encounter this error, it's likely due to an invalid tool cache issue in GitHub Copilot Agent mode. To resolve the issue:

1. PressCtrl+Shift+P to open the command palette
2. RunMCP: Reset cached tools
3. Restart the MCP server

For more details, seeGitHub issue #177

If you encounter this error, try runningnpx clear-npx-cache.

If you encounter other errors when starting the MCP server, you may also try the command above.

The Dev Box MCP provides tools for interacting with the following Microsoft Dev Box resources:

• DevBox Resource: Unified tool for DevBox management using scope patterns
  • List all DevBoxes across projects:/projects/*/users/me/devboxes/* (operation:read)
  • List DevBoxes in specific project:/projects/ProjectName/users/me/devboxes/* (operation:read)
  • Get specific DevBox details:/projects/ProjectName/users/me/devboxes/DevBoxName (operation:read)
  • Query DevBox by name across projects:/projects/*/users/me/devboxes/DevBoxName (operation:read)
  • Create new DevBox:/projects/ProjectName/users/me/devboxes/NewDevBoxName (operation:create)
  • Delete existing DevBox:/projects/ProjectName/users/me/devboxes/DevBoxName (operation:delete)

• Project Resource: Unified tool for Project management using scope patterns
  • List all projects:/projects/* (operation:read)
  • Get specific project details:/projects/projectName (operation:read)

• List Pools By Project: View all available Dev Box pools in a project

• DevBox Action: Unified tool for DevBox power management using scope patterns

  • Start DevBox:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:start)
  • Stop DevBox:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:stop)
  • Restart DevBox:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:restart)
  • Repair DevBox:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:repair)
  • Get Remote Connection:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:getRemoteConnection)

• Schedule Resource: Unified tool for DevBox schedule management using scope patterns

  • List all schedules:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:listAll)
  • Delay all scheduled actions:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:delayAll)
  • Skip all scheduled actions:/projects/ProjectName/users/userId/devboxes/DevBoxName (action:skipAll)

• List Customization Task Definitions By Project: View available customization tasks in a project
• Get Customization Task Definitions: Get details of a specific customization task
• Validate Customization Tasks: Validate a list of customization tasks
• List Customization Groups: View all customization groups for a Dev Box
• Get Customization Group: Get details of a specific customization group
• Create Customization Group: Apply customizations to a Dev Box
• Get Imaging Task Log: View logs for an imaging build task
• Run Tasks On Dev Box: Install packages or run commands on a Dev Box
• Get Customization Task Log: View logs for a customization task
• Set Dev Box Theme: Change the visual theme (dark/light) for a Dev Box

• Get Operation Status: Check status of long-running operations

• DevBox Think: Provides context for understanding and performing Dev Box operations

The Dev Box MCP Server usesDefaultAzureCredential andWAM (Web Account Manager) based brokered authentication for seamless Azure integration.

Authentication follows this credential chain order:

1. Environment Variables (EnvironmentCredential)
2. Managed Identity (ManagedIdentityCredential)
3. Visual Studio Code (VisualStudioCredential)
4. Azure CLI (AzureCliCredential)
5. Azure PowerShell (AzurePowerShellCredential)
6. Azure Developer CLI (AzureDeveloperCliCredential)
7. Windows SSO (Single Sign-On) (WAM - Web Account Manager)

The credential chain will attempt each method in order until a successful authentication is achieved. WAM provides seamless single sign-on experience on Windows platforms, automatically using your existing Windows credentials when available.

If you encounter authentication errors, try:

1. Make sure you're logged in to Windows SSO (Single Sign-On) or Azure CLI
2. Verify you have the necessary permissions in your Azure subscription
3. Check if you need to specify a specific tenant usingaz login --tenant <tenant-id>

Copyright (c) Microsoft Corporation. All rights reserved.

Dev Box

Bymicrosoft·7

This server enables natural language interactions for developer-focused operations like managing Dev Boxes, configurations, and pools.