Skip to main content
Glama
Waldur MCP Server

Waldur MCP Server

Official
by waldur

Waldur MCP サーバー

Waldur MCPサーバーは、モデルコンテキストプロトコル(MCP)を実装することで、WaldurインスタンスとClaude Desktopの統合を可能にします。これにより、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 デスクトップ 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が表示されます。

よくある問題

  • 無効なトークン: トークンの権限と有効期限を確認してください

  • 接続の問題: 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.
      18 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.
      -