Waldur MCP server
About
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.
Details
- Author
- MCP-Mirror
- Downloads
- 230
- Categories
- Other
Jump to
- 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.
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 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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"waldur mcp server": {
"waldur_waldur-mcp-server": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"waldur_waldur-mcp-server": {
"command": "uv",
"args": [
"sync"
]
}
}Waldur MCP server
Quickstart
1. Install Claude Desktop for your platform from the Claude Desktop releases page
2. Install Python 3.10 or higher.
3. Install uv package manager.
Claude Desktop MCP Server Configuration
On Windows: \AppData\Roaming\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/api",
"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/api",
"WALDUR_TOKEN": "your-token"
}
}
}
</details>
Development
Building and Publishing
To prepare the package for distribution:
1. Sync dependencies and update lockfile:
uv sync
2. Build package distributions:
uv build
This will create source and wheel distributions in the dist/ directory.
3. Publish to PyPI:
uv publish
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token: --token or UV_PUBLISH_TOKEN
- Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD
Debugging
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
