https://github.com/pulumi/mcp-server
Pulumi MCP Server
https://github.com/pulumi/mcp-server
Last synced: 13 days ago
JSON representation
Pulumi MCP Server
- Host: GitHub
- URL: https://github.com/pulumi/mcp-server
- Owner: pulumi
- License: apache-2.0
- Created: 2025-04-03T17:46:47.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-10T12:48:27.000Z (30 days ago)
- Last Synced: 2025-04-26T12:55:16.179Z (14 days ago)
- Language: TypeScript
- Homepage:
- Size: 188 KB
- Stars: 14
- Watchers: 11
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-devops-mcp-servers - pulumi/mcp-server - MCP server for interacting with Pulumi using the Pulumi Automation API and Pulumi Cloud API. Enables MCP clients to perform Pulumi operations like retrieving package information, previewing changes, deploying updates, and retrieving stack outputs programmatically. (Cloud Infrastructure / 🏗️ Infrastructure as Code)
- awesome-devops-mcp-servers - pulumi/mcp-server - MCP server for interacting with Pulumi using the Pulumi Automation API and Pulumi Cloud API. Enables MCP clients to perform Pulumi operations like retrieving package information, previewing changes, deploying updates, and retrieving stack outputs programmatically. (Cloud Infrastructure / 🏗️ Infrastructure as Code)
README
# Pulumi MCP Server
> **Note:** This MCP server is currently under active development. Its API (including available commands and their arguments) is experimental and may introduce breaking changes without notice. Please file an issue on [GitHub](https://github.com/pulumi/mcp-server/issues) if you encounter bugs or need support for additional Pulumi commands.
A server implementing the [Model Context Protocol](https://modelcontextprotocol.io) (MCP) for interacting with Pulumi CLI using the Pulumi Automation API and Pulumi Cloud API.
This package allows MCP clients to perform Pulumi operations like retrieving package information, previewing changes, deploying updates, and retrieving stack outputs programmatically without needing the Pulumi CLI installed directly in the client environment.
## Usage
The Pulumi CLI has to be installed on you machine.
This package is primarily intended to be integrated into applications that can use MCP servers as AI tools. For example, here is how you can include Pulumi MCP Server in Claude desktop's MCP configuration file:
```json
{
"mcpServers": {
"pulumi": {
"command": "npx",
"args": ["@pulumi/mcp-server@latest"]
}
}
}
```
## Docker Container
You can also run the Pulumi MCP Server as a Docker container. This approach eliminates the need to install Node.js and the package dependencies directly on your host machine.
### Building the Container
To build the container:
```bash
docker build -t pulumi/mcp-server:latest .
```
### Using with MCP Clients
To use the containerized server with MCP clients, you'll need to configure the client to use the Docker container. For example, in Claude desktop's MCP configuration:
```json
{
"mcpServers": {
"pulumi": {
"command": "docker",
"args": ["run", "-i", "--rm", "pulumi/mcp-server:latest"]
}
}
}
```
For Pulumi operations that require access to local Pulumi projects, you'll need to mount the appropriate directories. For example, if your Pulumi project is in `~/projects/my-pulumi-app`:
```json
{
"mcpServers": {
"pulumi": {
"command": "docker",
"args": ["run", "-i", "--rm", "-v", "~/projects/my-pulumi-app:/app/project", "pulumi/mcp-server:latest"]
}
}
}
```
Then when using the MCP tools, you would reference the project directory as `/app/project` in your requests.
## Available Commands
The server exposes handlers for the following Pulumi operations, callable via MCP requests:
* **`preview`**: Runs `pulumi preview` on a specified stack.
* `workDir` (string, required): The working directory containing the `Pulumi.yaml` project file.
* `stackName` (string, optional): The stack name to operate on (defaults to 'dev').
* **`up`**: Runs `pulumi up` to deploy changes for a specified stack.
* `workDir` (string, required): The working directory containing the `Pulumi.yaml` project file.
* `stackName` (string, optional): The stack name to operate on (defaults to 'dev').
* **`stack-output`**: Retrieves outputs from a specified stack after a successful deployment.
* `workDir` (string, required): The working directory containing the `Pulumi.yaml` project file.
* `stackName` (string, optional): The stack name to retrieve outputs from (defaults to 'dev').
* `outputName` (string, optional): The specific stack output name to retrieve. If omitted, all outputs for the stack are returned.
* **`get-resource`**: Returns information about a specific Pulumi Registry resource, including its inputs and outputs.
* `provider` (string, required): The cloud provider (e.g., 'aws', 'azure', 'gcp', 'random') or `github.com/org/repo` for Git-hosted components.
* `module` (string, optional): The module to query (e.g., 's3', 'ec2', 'lambda').
* `resource` (string, required): The resource type name (e.g., 'Bucket', 'Function', 'Instance').
* **`list-resources`**: Lists available resources within a Pulumi provider package, optionally filtered by module.
* `provider` (string, required): The cloud provider (e.g., 'aws', 'azure', 'gcp', 'random') or `github.com/org/repo` for Git-hosted components.
* `module` (string, optional): The module to filter by (e.g., 's3', 'ec2', 'lambda').
## Development
1. Clone the repository.
2. Install dependencies: `make ensure`
3. Build the project: `make build`
4. Test the project: `make test`
## License
This project is licensed under the Apache-2.0 License. See the [LICENSE](LICENSE) file for details.