Waldur MCP Server
local-only server
The server can only run on the client’s local machine because it depends on local resources.
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
- Install Claude Desktop for your platform from the Claude Desktop releases page
- Install Python 3.13 or higher.
- Install uv package manager.
Installation
To install the package:
Or with uv:
Generate Waldur Token
- Log in to your Waldur instance
- Navigate to Username > Credentials > API Token
- 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
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:
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
You must be authenticated.
The Waldur MCP Server facilitates interaction with Waldur instances via MCP, allowing seamless integration and management of services through customized API access.