Overview
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.
