What is Waldur Mcp Server

Waldur MCP server is a server that implements the Model Context Protocol (MCP) for integrating Waldur instances with Claude Desktop, allowing direct interaction between the two systems.

Use cases

Use cases for Waldur MCP server include automating workflows between Waldur and Claude Desktop, managing resources in cloud environments, and enhancing user experience through direct API interactions.

How to use

To use Waldur MCP server, install Claude Desktop, Python 3.13 or higher, and the uv package manager. Then, install the Waldur MCP server package using pip or uv, generate a Waldur API token, and configure the server settings in the Claude Desktop configuration file.

Key features

Key features of Waldur MCP server include seamless integration with Claude Desktop, support for API token authentication, and easy configuration for both development and production environments.

Where to use

Waldur MCP server can be used in software development environments, particularly for applications that require integration between cloud management platforms and desktop applications.

Waldur MCP server

Waldur MCP server enables integration between Waldur instance and Claude Desktop by implementing the Model Context Protocol (MCP). This allows Claude to interact with your Waldur instance directly.

Quickstart

1. Install Claude Desktop for your platform from the Claude Desktop releases page

2. Install Python 3.13 or higher.

3. Install uv package manager.

Installation

To install the package:

pip install waldur-mcp-server

Or with uv:

uv pip install waldur-mcp-server

Generate Waldur Token

1. Log in to your Waldur instance
2. Navigate to Username > Credentials > API Token
3. Generate a new token with appropriate token lifetime - you’ll need it for configuration

Claude Desktop MCP Server Configuration

On Windows: %APPDATA%\Claude\claude_desktop_config.json

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\waldur_service",
        "run",
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uvx",
      "args": [
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

Debugging

On macOS, log files are located at ~/Library/Logs/Claude/mcp.log

If you encounter a spawn uvx ENOENT error, verify that your PATH environment variable includes the Python installation directory where uv is installed. Alternatively, you can specify the full path to uvx in the configuration file, for example:
~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx

Since MCP servers run over stdio, debugging can be challenging. For the best debugging
experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector uv --directory C:\\waldur_service run waldur-mcp-server

When debugging, you’ll need to set the required environment variables. Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Common issues

• Invalid token: Verify token permissions and expiration
• Connection issues: Check WALDUR_API_URL is accessible