Waldur MCP server
About
Integrates Waldur instances with Claude Desktop using the Model Context Protocol (MCP).
Details
- Author
- waldur
- GitHub stars
- 2
- Downloads
- 103
- Categories
- Cloud Service, Infrastructure, API, Other
Jump to
- Integrates Waldur instance with Claude Desktop
- Implements the Model Context Protocol (MCP)
- Allows direct Claude interaction with Waldur
- Configuration via environment variables
- Supports published and development server modes
- Debuggable via MCP Inspector
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Waldur MCP serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Claude Desktop, Python 3.13+, and uv. Then install the package via pip install waldur-mcp-server or uv pip install waldur-mcp-server. Generate an API token from your Waldur instance (Username > Credentials > API Token). Configure Claude Desktop by editing claude_desktop_config.json with environment variables WALDUR_API_URL and WALDUR_TOKEN.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"waldur mcp server": {
"waldur-mcp-server": {
"command": "uv",
"args": [
"pip",
"install",
"waldur-mcp-server"
]
}
}
}
}McpServers
{
"waldur-mcp-server": {
"command": "uv",
"args": [
"pip",
"install",
"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
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
<details>
<summary>Development/Unpublished Servers Configuration</summary>
{
"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"
}
}
}
}
</details>
<details>
<summary>Published Servers Configuration</summary>
{
"mcpServers": {
"waldur-mcp-server": {
"command": "uvx",
"args": [
"waldur-mcp-server"
],
"env": {
"WALDUR_API_URL": "https://your-waldur-instance",
"WALDUR_TOKEN": "your-token"
}
}
}
}
</details>
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
