Waldur MCP Server
OfficialWaldur MCP 服务器
Waldur MCP 服务器通过实现模型上下文协议 (MCP),实现了 Waldur 实例与 Claude 桌面的集成。这使得 Claude 能够直接与您的 Waldur 实例进行交互。
快速入门
从 Claude Desktop 发布页面为您的平台安装 Claude Desktop
安装 Python 3.13 或更高版本。
安装 uv 包管理器。
安装
要安装该包:
pip install waldur-mcp-server或者使用 uv:
uv pip install waldur-mcp-server生成 Waldur 代币
登录您的 Waldur 实例
导航至用户名 > 凭证 > API 令牌
生成具有适当令牌生命周期的新令牌 - 您将需要它进行配置
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 toolscreate_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
Scored across 7 tools
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.
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.
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.
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
Related MCP Connectors
The official MCP Server for the Mux API
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Build, test, publish and manage real MCP servers from APIs with a live developer studio.
31A MCP server built for developers enabling Git based project management with project and personal…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP 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 npm4MIT
- AlicenseNot gradedqualityCmaintenanceMCP 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 npm3MIT

MCP Server Weaviateofficial
FlicenseNot gradedqualityDmaintenanceThe 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-- FlicenseNot gradedqualityCmaintenanceAn 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.-