Skip to main content
Glama
Waldur MCP Server

Waldur MCP Server

Official
by waldur

Waldur MCP 服务器

Waldur MCP 服务器通过实现模型上下文协议 (MCP),实现了 Waldur 实例与 Claude 桌面的集成。这使得 Claude 能够直接与您的 Waldur 实例进行交互。

快速入门

  1. 从 Claude Desktop 发布页面为您的平台安装 Claude Desktop

  2. 安装 Python 3.13 或更高版本。

  3. 安装 uv 包管理器。

安装

要安装该包:

pip install waldur-mcp-server

或者使用 uv:

uv pip install waldur-mcp-server

生成 Waldur 代币

  1. 登录您的 Waldur 实例

  2. 导航至用户名 > 凭证 > API 令牌

  3. 生成具有适当令牌生命周期的新令牌 - 您将需要它进行配置

Claude Desktop MCP 服务器配置

在 Windows 上: %APPDATA%\Claude\claude_desktop_config.json

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

调试

在 macOS 上,日志文件位于~/Library/Logs/Claude/mcp.log

如果遇到spawn uvx ENOENT错误,请检查 PATH 环境变量是否包含安装uv Python 安装目录。或者,您也可以在配置文件中指定uvx的完整路径,例如: ~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx

由于 MCP 服务器通过 stdio 运行,调试起来可能比较困难。为了获得最佳调试体验,我们强烈建议使用MCP Inspector 。

您可以使用以下命令通过npm启动 MCP Inspector:

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

调试时,您需要设置所需的环境变量。启动后,检查器将显示一个 URL,您可以在浏览器中访问该 URL 来开始调试。

常见问题

  • 令牌无效:验证令牌权限和有效期

  • 连接问题:检查 WALDUR_API_URL 是否可访问

Available Tools

7 tools
create_invitationB

Invite users to project or organization by email

Args: scope_type: Whether to invite users to organization or project scope_name: Name of the organization or project to invite users to role: Role to assign to invited users emails: List of email addresses to invite extra_invitation_text: Custom message to include in the invitation

Inputs: scope_type (required), scope_name (required), role (required), emails (required), +1 more.

list_customersC

List all customers

Inputs: no named parameters.

list_invoicesC

List all invoices

Inputs: no named parameters.

list_offeringsC

List all offerings

Inputs: no named parameters.

list_projectsC

List all projects

Inputs: no named parameters.

list_resourcesC

List all resources

Inputs: no named parameters.

queryC

Run a read-only SQL query

Inputs: sql (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 7 tools

    Disambiguation4/5

    Most tools have distinct purposes: list_customers, list_invoices, list_offerings, list_projects, and list_resources each target different Waldur entities, while create_invitation and query serve unique functions. However, the five list_* tools could potentially be confused for similar listing operations, though their descriptions clarify distinct scopes.

    Naming Consistency5/5

    Tool names follow a highly consistent pattern: six tools use verb_noun format (e.g., create_invitation, list_customers), and the seventh (query) aligns with a simple verb style. All names are in snake_case, making them predictable and readable across the set.

    Tool Count4/5

    With 7 tools, the count is reasonable for a management server, covering core listing operations and key actions like invitations and queries. It feels slightly thin for comprehensive Waldur management, but each tool serves a clear purpose without bloat.

    Completeness2/5

    The tool set is severely incomplete for Waldur management, focusing heavily on listing operations with only one creation tool (create_invitation) and a generic query. Missing are essential CRUD operations for customers, invoices, offerings, projects, and resources (e.g., create, update, delete), leaving significant gaps that will hinder agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      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.
      39 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      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.
      26 npm
      3
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      The MCP Server for Weaviate facilitates integration with Weaviate using a customizable Python-based server, enabling interaction with Weaviate databases and OpenAI APIs via configurable URL and API keys.
      162
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      An MCP server with HTTP/stdio support, a web admin panel for managing services, capabilities, and user permissions with Bearer token authentication, enabling relay and access control for MCP tools.
      -