uvx로 설치하기

uvx로 설치하기

uv는 Astral의 Python 패키지 매니저이자 툴체인이에요. uvx는 게시된 패키지의 커맨드를 격리된 환경에서 실행하며, 해당 패키지를 전역적으로 설치하지 않습니다. Node.js의 npx와 비슷하다고 생각하면 돼요.

uvx를 사용하면 릴리스 바이너리를 직접 설치하지 않고도 Grafana MCP 서버를 실행할 수 있습니다.

출처: 문서

본문

무엇을 할 수 있을까요

서버를 MCP 클라이언트 설정(예: Claude Desktop이나 Cursor)에 추가하고, URL과 서비스 계정 토큰을 사용해 Grafana에 연결할 수 있어요.

시작하기 전에

uv를 설치하고 uvx가 $PATH에 있는지 확인하세요. 그리고 Grafana 인스턴스(Grafana 9.0 이상)와 서비스 계정 토큰이 필요합니다.

MCP 클라이언트에 서버 추가하기

MCP 클라이언트 설정 파일에 다음을 추가하세요. Grafana URL이 다르다면 http://localhost:3000을, 서비스 계정 토큰은 YOUR_SERVICE_ACCOUNT_TOKEN을 각각 여러분의 값으로 바꿔주세요.

{
  "mcpServers": {
    "grafana": {
      "command": "uvx",
      "args": ["mcp-grafana"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<YOUR_SERVICE_ACCOUNT_TOKEN>"
      }
    }
  }
}

Grafana Cloud를 사용한다면 GRAFANA_URL을 인스턴스 URL(예: https://myinstance.grafana.net)로 설정하세요.

다음 단계

더 알아보기 (Learn more)