Waldur MCP Server

Waldur MCP服务器

Waldur MCP服务器通过实现模型上下文协议（MCP）实现了Waldur实例和Claude Desktop之间的集成。这允许Claude直接与您的Waldur实例交互。

快速启动

1. 从以下位置为您的平台安装Claude Desktop Claude Desktop发布页面

1. 安装Python 3.13或更高版本。

1. 安装uv包管理器。

安装

要安装该软件包，请执行以下操作：

pip install waldur-mcp-server

或者使用紫外线：

uv pip install waldur-mcp-server

生成Waldur代币

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

Claude桌面MCP服务器配置

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

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

Development/Unpublished Servers Configuration

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

Published Servers Configuration

{
  "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环境变量是否包含Python安装目录，其中 uv 已安装。或者，您可以指定以下内容的完整路径 uvx 在配置文件中，例如： ~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx

由于MCP服务器在stdio上运行，调试可能具有挑战性。为了达到最佳调试效果 经验，我们强烈建议使用 MCP检查员.

您可以通过以下方式启动MCP检查器 使用此命令：

npx @modelcontextprotocol/inspector uv --directory C:\\waldur_service run waldur-mcp-server

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

常见问题

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