金大哥 - waldur-mcp-server MCP 详情

article

README

🚀 Waldur MCP 服务器

Waldur MCP 服务器通过实现模型上下文协议 (MCP)，让您的 Waldur 实例能够与 Claude Desktop 直接进行交互，从而使 Claude 可直接与您的 Waldur 实例通信。

🚀 快速开始

准备工作

从 Claude Desktop 发布页面安装适合您所在平台的 Claude Desktop。
安装 Python 3.13 或更高版本。
安装 uv 包管理器。

📦 安装指南

要安装 waldur-mcp-server 包，您可以选择以下任意一种方式：

使用 pip

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 环境变量是否包含 Python 安装目录中的 uv。或者在配置文件中指定 uvx 的完整路径，例如：~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx。
调试工具：由于 MCP 服务器通过标准输入输出运行，调试可能具有一定挑战性。为了获得最佳的调试体验，我们强烈推荐使用 MCP 监视器。您可以通过以下命令启动 MCP 监视器：

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

启动后，监视器会显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

常见问题解答

⚠️ 重要提示

无效令牌：请检查令牌权限和过期时间。

连接问题：请确认 WALDUR_API_URL 可用。

waldur-mcp-server