🚀 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可用。