waldur MCP服务器
Waldur MCP服务器通过MCP促进与Waldur实例的交互，通过定制的API访问实现服务的无缝集成和管理。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"waldur-mcp-server": {
"args": [
"waldur-mcp-server"
],
"command": "uvx",
"env": {
"WALDUR_API_URL": "https://your-waldur-instance",
"WALDUR_TOKEN": "your-token"
}
}
}
}该服务需要配置环境变量：UV_PUBLISH_PASSWORD、UV_PUBLISH_TOKEN、UV_PUBLISH_USERNAME、WALDUR_API_URL、WALDUR_TOKEN
可用工具 （7 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
query 1 个参数 需填 1 项
Run a read-only SQL query
必填参数：sql
list_customers
List all customers
该工具无需必填参数，直接调用即可
list_projects
List all projects
该工具无需必填参数，直接调用即可
list_resources
List all resources
该工具无需必填参数，直接调用即可
list_invoices
List all invoices
该工具无需必填参数，直接调用即可
list_offerings
List all offerings
该工具无需必填参数，直接调用即可
create_invitation 5 个参数 需填 4 项
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
必填参数：scope_type、scope_name、role、emails
服务介绍
Waldur 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 服务器运行于标准输入输出之上，调试可能会比较困难。为了获得最佳调试体验，我们强烈建议使用 MCP Inspector。
您可以使用以下命令通过 npm 启动 MCP Inspector：
npx @modelcontextprotocol/inspector uv --directory C:\\waldur_service run waldur-mcp-server
在调试过程中，您需要设置所需的环境变量。启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 开始调试。
常见问题
- 无效令牌：验证令牌权限和过期时间
- 连接问题：检查 WALDUR_API_URL 是否可访问
