Model Context Protocol (MCP) Server
The Defang Model Context Protocol (MCP) Server includes built-in tools to allow users to deploy and manage cloud services through a supported IDE.
Using this MCP Server with an IDE will enable the AI coding agent (e.g. Copilot) to use Defang tools and resources to perform tasks, such as deploying a service to the cloud. This means you can now use Defang with IDE-integrated AI coding agents.
For more details about MCP architecture, visit the official MCP documentation.
This page is a guide to the Defang MCP Server detailing its installation, tools, and usage. If you are looking for an example of how you can deploy a MCP project with Defang, please instead refer to our MCP sample application.
Installation
Ensure that you have the npm package manager installed, as npx
commands are required for setup.
At this time, the Defang MCP Server can only be installed using npx
. Other methods are not yet supported.
Run the setup command in your terminal for your IDE of choice from the Supported IDEs section. This will connect the Defang MCP Server to your IDE. The general format of the command is as follows:
npx -y defang@latest mcp setup --client=<your-ide>
Once the command completes, you may need to restart your IDE for the changes to take effect.
Once the MCP Server is running, you can access the Defang MCP tools directly through the AI agent chat in your IDE.
That's it! Feel free to explore our Example Prompts to get ideas on how to interact with the AI agent and make the most of the Defang MCP Server.
Supported IDEs
Cursor
Setup command:
npx -y defang@latest mcp setup --client=cursor
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like check defang services
or other prompts. Here's an example of what it could look like:
Windsurf
Setup command:
npx -y defang@latest mcp setup --client=windsurf
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like check defang services
or other prompts. Here's an example of what it could look like:
VS Code
Setup command:
npx -y defang@latest mcp setup --client=vscode
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like check defang services
or other prompts. Here's an example of what it could look like:
VS Code Insiders
Setup command:
npx -y defang@latest mcp setup --client=vscode-insiders
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like check defang services
or other prompts. Here's an example of what it could look like:
Claude Desktop
While this is not an IDE in the traditional sense, it can support MCP servers. For a smoother experience, consider specifying a project name or directory when making chat prompts to this platform.
Setup command:
npx -y defang@latest mcp setup --client=claude
Once setup is complete, you can interact with the AI coding agent using Defang-related actions like check defang services
or other prompts. Here's an example of what it could look like:
MCP Tools
Below are the tools available in the Defang MCP Server.
deploy
The deploy
tool scans your project directory for Dockerfiles and compose.yaml
files, then deploys the detected service(s) using Defang. You can monitor the deployment process in the Defang Portal.
The Defang MCP Server currently supports deployments to Defang Playground. We plan to support BYOC in future updates.
services
The services
tool displays the details of all your services that are currently deployed in your project with Defang. It shows the Service Name, Deployment ID, Public URL and Service Status. If there are no services found, it will display an appropriate message.
destroy
Given a project name or directory, the destroy
tool identifies any services deployed with Defang and terminates them. If no services are found, it will display an appropriate message.
Example Prompts
After connecting the Defang MCP Server to your IDE using an installation method, you can type in prompts in your chat to invoke the AI agent to use any MCP tool(s).
For example, you can ask the AI agent:
can you deploy this to defang?
please destroy this project.
what services do I have?
You can also choose to specify a project name or project directory if you do not have the project open:
deploy this with defang /Users/yourname/Documents/project1
do I have a service called project1
Feel free to try any of these prompts or create your own!