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 開始調試。