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 是否可访问