Waldur MCP server

What is Waldur MCP server?

The Waldur MCP server is an MCP-compliant server that connects to a Waldur instance through its API. It is configured via environment variables for the API URL and authentication token, and runs using the uv package manager. The server is distributed as a Python package on PyPI.

How to use Waldur MCP server?

Install Python 3.10 or higher and the uv package manager. Then configure Claude Desktop by adding the server to claude_desktop_config.json. For a published server, use the command uvx waldur-mcp-server with the environment variables WALDUR_API_URL and WALDUR_TOKEN. For development, use uv --directory <path> run waldur-mcp-server instead.

Key features of Waldur MCP server

• Connects to a Waldur instance via its API.
• Configured solely through environment variables.
• Published and installable from PyPI.
• Runs as a stdio MCP server.
• Debuggable using the MCP Inspector.

Use cases of Waldur MCP server

—

FAQ from Waldur MCP server

What Python version is required?

Python 3.10 or higher is required.

How do I configure the server in Claude Desktop?

Add an entry to the mcpServers section of claude_desktop_config.json with the command uvx (published) or uv (development) and include the environment variables WALDUR_API_URL and WALDUR_TOKEN.

What environment variables are needed?

You must set WALDUR_API_URL (the API endpoint of your Waldur instance) and WALDUR_TOKEN (your authentication token).

How is the server published to PyPI?

Run uv build to create distributions, then uv publish to upload to PyPI. You can authenticate via a token (--token or UV_PUBLISH_TOKEN) or username/password.

How can I debug the server?

Use the MCP Inspector by running npx @modelcontextprotocol/inspector uv --directory <path> run waldur-mcp-server with the required environment variables set.