This is a Model Context Protocol (MCP) server for Microsoft 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.
Node.js 18 or newer
Azure Resources
MCP Client
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, see here
⨠One-Click Install on VS CodeClick 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! ð
ð§ Manual Install on VS CodeFor a step-by-step installation, follow one of the following instructions:
.vscode/mcp.json
to your workspace:{ "servers": { "DevBox": { "command": "npx", "args": ["-y", "@microsoft/devbox-mcp@latest"] } } }
{ "mcp": { "servers": { "DevBox": { "command": "npx", "args": ["-y", "@microsoft/devbox-mcp@latest"] } } } }
# For VS Code code --add-mcp '{"name":"DevBox","command":"npx","args":["-y","@microsoft/devbox-mcp@latest"]}'
For detailed MCP installation steps on VS Code, see here.
Tool call failed with 'Tool xxx does not have an implementation registered' or 'I apologize for the technical issue'If you encounter this error, it's likely due to an invalid tool cache issue in GitHub Copilot Agent mode. To resolve the issue:
Ctrl+Shift+P
to open the command paletteMCP: Reset cached tools
For more details, see GitHub issue #177
Error: Cannot find module '../build/Release/keytar.node'If you encounter this error, try running npx clear-npx-cache
.
If you encounter other errors when starting the MCP server, you may also try the command above.
ð ï¸ Currently Supported ToolsThe Dev Box MCP provides tools for interacting with the following Microsoft Dev Box resources:
/projects/*/users/me/devboxes/*
(operation: read
)/projects/ProjectName/users/me/devboxes/*
(operation: read
)/projects/ProjectName/users/me/devboxes/DevBoxName
(operation: read
)/projects/*/users/me/devboxes/DevBoxName
(operation: read
)/projects/ProjectName/users/me/devboxes/NewDevBoxName
(operation: create
)/projects/ProjectName/users/me/devboxes/DevBoxName
(operation: delete
)/projects/*
(operation: read
)/projects/projectName
(operation: read
)DevBox Action: Unified tool for DevBox power management using scope patterns
/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: start
)/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: stop
)/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: restart
)/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: repair
)/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: getRemoteConnection
)Schedule Resource: Unified tool for DevBox schedule management using scope patterns
/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: listAll
)/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: delayAll
)/projects/ProjectName/users/userId/devboxes/DevBoxName
(action: skipAll
)The Dev Box MCP Server uses DefaultAzureCredential and WAM (Web Account Manager) based brokered authentication for seamless Azure integration.
Authentication follows this credential chain order:
EnvironmentCredential
)ManagedIdentityCredential
)VisualStudioCredential
)AzureCliCredential
)AzurePowerShellCredential
)AzureDeveloperCliCredential
)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:
az login --tenant <tenant-id>
Copyright (c) Microsoft Corporation. All rights reserved.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4