Waldur MCP 서버

Waldur MCP 서버는 모델 컨텍스트 프로토콜(MCP)을 구현하여 Waldur 인스턴스와 Claude Desktop 간의 통합을 지원합니다. 이를 통해 Claude는 Waldur 인스턴스와 직접 상호 작용할 수 있습니다.

빠른 시작

Claude Desktop 릴리스 페이지에서 플랫폼에 맞는 Claude Desktop을 설치하세요.
Python 3.13 이상을 설치하세요.
uv 패키지 관리자를 설치합니다.

설치

패키지를 설치하려면:

지엑스피1

또는 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 환경 변수에 uv 설치된 Python 설치 디렉터리가 포함되어 있는지 확인하세요. 또는 구성 파일에 uvx 의 전체 경로를 지정할 수 있습니다(예: ~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx

MCP 서버는 stdio를 통해 실행되므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector 사용을 강력히 권장합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

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

디버깅할 때는 필요한 환경 변수를 설정해야 합니다. 실행 시 Inspector에 브라우저에서 액세스할 수 있는 URL이 표시되어 디버깅을 시작할 수 있습니다.

일반적인 문제

잘못된 토큰: 토큰 권한 및 만료를 확인하세요
연결 문제: WALDUR_API_URL에 액세스할 수 있는지 확인하세요.

Waldur MCP Server