Waldur MCP server

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 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

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

常见问题

• 令牌无效：检查令牌权限和有效期
• 连接问题：检查是否可以访问 WALDUR_API_URL