Waldur MCP 服务器快速入门指南

1. 安装 Claude Desktop
   根据您使用的平台，在 Claude Desktop 发行页面 下载并安装适合的版本。

2. 安装 Python
   安装 Python 3.10 或更高版本。

3. 安装 uv 包管理器。

Claude Desktop MCP 服务器配置

在 Windows 系统中，配置文件路径为：\AppData\Roaming\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/api",
      "WALDUR_TOKEN": "your-token"
    }
  }
}

已发布的服务器配置

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

开发

构建和发布

要准备分发包：

1. 同步依赖项并更新锁定文件：

   uv sync
   

2. 构建分发包：

   uv build
   

   这将在 dist/ 目录下创建源代码和轮分布。

3. 发布到 PyPI：

   uv publish
   

   注意：您需要通过环境变量或命令行参数设置 PyPI 凭证：

   • 令牌：--token 或 UV_PUBLISH_TOKEN
   • 或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器运行在标准输入输出上，调试可能会比较困难。为了获得最佳的调试体验，我们强烈推荐使用 MCP Inspector。

您可以通过 npm 执行以下命令启动 MCP Inspector：

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

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