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 Token

1. 登录到您的 Waldur 实例
2. 导航到 用户名 > 凭据 > API Token
3. 生成具有适当 token 生存期的新 token - 您将需要它进行配置

Claude Desktop MCP 服务器配置

在 Windows 上：%APPDATA%\Claude\claude_desktop_config.json

在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json

<details> <summary>开发/未发布服务器配置</summary>

{
  "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"
      }
    }
  }
}

</details>

<details> <summary>已发布服务器配置</summary>

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uvx",
      "args": [
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

</details>

调试

在 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 以开始调试。

常见问题

• 无效 token：验证 token 权限和过期时间
• 连接问题：检查 WALDUR_API_URL 是否可访问