Waldur MCP Server

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:

pip install waldur-mcp-server

Or with uv:

uv pip install waldur-mcp-server

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

{
  "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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

The Waldur MCP Server facilitates interaction with Waldur instances via MCP, allowing seamless integration and management of services through customized API access.

Quickstart

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-nodejs-server
gentoro-GT
-
security
A
license
-
quality
MCP Server for the Gentoro services, enabling Claude to interact with Gentoro, which allows users to create and integrate tools into a common Bridge, defining all available capabilities.
Last updated -
61
2
TypeScript
Apache 2.0
MCP Server
la-rebelion
-
security
A
license
-
quality
MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
Last updated -
4
3
TypeScript
MIT License
MCP Server
agentico-dev
-
security
A
license
-
quality
MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
Last updated -
13
2
TypeScript
MIT License
mcp-browser-use
vinayak-mehta
-
security
A
license
-
quality
An MCP server that connects any MCP client (like Claude or Cursor) with the browser using browser-use, allowing clients to utilize existing LLMs without requiring additional API keys.
Last updated -
32
Python
Apache 2.0

View all related MCP servers

Waldur MCP Server