Waldur Waldur MCP Server

🚀 Waldur MCP 服务器快速入门指南

本指南将帮助您快速搭建和配置 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 开始调试。