Waldur Waldur MCP Server

🚀 Waldur MCP Server Quick Start Guide

This guide provides a step-by-step process to quickly set up and start using the Waldur MCP Server. It includes installation instructions, server configuration details, and development-related information.

🚀 Quick Start

Step 1: Install Claude Desktop

Download and install the appropriate version of Claude Desktop from the Claude Desktop Release Page based on your platform.

Step 2: Install Python

Install Python 3.10 or a higher version.

Step 3: Install the uv Package Manager

Install the uv package manager.

📦 Installation

Claude Desktop MCP Server Configuration

On Windows systems, the configuration file path is: \AppData\Roaming\Claude\claude_desktop_config.json.

Development/Unreleased Server Configuration

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

Released Server Configuration

"mcpServers": {
  "waldur-mcp-server": {
    "command": "uvx",
    "args": [
      "waldur-mcp-server"
    ],
    "env": {
      "WALDUR_API_URL": "https://your-waldur-instance/api",
      "WALDUR_TOKEN": "your-token"
    }
  }
}

💻 Usage Examples

Development

Build and Publish

To prepare a distribution package:

1. Synchronize dependencies and update the lock file:

uv sync

2. Build the distribution package:

uv build

This will create source and wheel distributions in the dist/ directory.

3. Publish to PyPI:

uv publish

Note: You need to set your PyPI credentials via environment variables or command-line arguments:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Debugging can be challenging since the MCP server runs on standard input and output. For the best debugging experience, we highly recommend using MCP Inspector.

You can start the MCP Inspector via npm with the following command:

npx @modelcontextprotocol/inspector uv --directory C:\\waldur_service run waldur-mcp-server

When debugging, you need to set the required environment variables. After starting, the Inspector will display a URL that you can access in your browser to begin debugging.