Waldur MCP Server logo

Waldur MCP Server

by waldur

Waldur MCP server enables integration between a Waldur instance and Claude Desktop by implementing the Model Context Protocol (MCP). This allows Claude to interact with your Waldur instance directly.

View on GitHub

Last updated: N/A

What is Waldur MCP Server?

Waldur MCP server is a component that allows the Claude Desktop application to interact with a Waldur instance using the Model Context Protocol (MCP). It acts as a bridge, enabling Claude to access and utilize data from the Waldur platform.

How to use Waldur MCP Server?

To use the Waldur MCP server, you need to install it using pip or uv, generate a Waldur API token, and configure Claude Desktop to connect to the server using the token and Waldur API URL. Detailed instructions for installation and configuration are provided in the README.

Key features of Waldur MCP Server

  • Integration with Claude Desktop

  • Model Context Protocol (MCP) support

  • Waldur API access

  • Configuration via JSON file

  • Debugging support with MCP Inspector

Use cases of Waldur MCP Server

  • Enabling Claude to access and utilize data from Waldur instances

  • Integrating AI models with Waldur infrastructure management

  • Automating tasks in Waldur using Claude

  • Providing context to Claude for better understanding of Waldur resources

FAQ from Waldur MCP Server

How do I install the Waldur MCP server?

You can install it using pip or uv: pip install waldur-mcp-server or uv pip install waldur-mcp-server

How do I generate a Waldur API token?

Log in to your Waldur instance, navigate to Username > Credentials > API Token, and generate a new token with appropriate token lifetime.

Where is the Claude Desktop configuration file located?

On Windows: %APPDATA%\Claude\claude_desktop_config.json. On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

How do I debug the Waldur MCP server?

Use the MCP Inspector for the best debugging experience. You can launch it via npx @modelcontextprotocol/inspector uv --directory C:\waldur_service run waldur-mcp-server

What should I do if I 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.