Docker로 설치하기

Docker로 설치하기

Docker Hub의 공식 이미지를 사용해 Grafana MCP 서버를 실행할 수 있어요. 이 이미지는 기본적으로 SSE를 사용하지만, 대부분의 사용자는 Claude Desktop 같은 AI 어시스턴트와 직접 통합하기 위해 STDIO 모드를 사용하려 할 거예요.

출처: 문서

본문

무엇을 할 수 있을까요

컨테이너에서 서버를 실행하고 MCP 클라이언트를 연결할 수 있어요. stdio(Claude Desktop 등에서 일반적), SSE, streamable HTTP, 또는 서버 TLS를 적용한 streamable HTTP를 사용할 수 있습니다.

시작하기 전에

  • Docker 설치
  • Grafana 인스턴스(Grafana 9.0 이상)와 서비스 계정 토큰

STDIO 모드로 서버 실행하기

AI 어시스턴트와의 직접 통합을 위해 대부분의 사용자는 STDIO 모드를 사용합니다. -t stdio와 -i를 전달해 컨테이너가 stdin을 열어두게 하세요.

로컬 Grafana:

docker pull grafana/mcp-grafana
docker run --rm -i \
  -e GRAFANA_URL=http://localhost:3000 \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> \
  grafana/mcp-grafana -t stdio

Grafana Cloud:

docker pull grafana/mcp-grafana
docker run --rm -i \
  -e GRAFANA_URL=https://myinstance.grafana.net \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> \
  grafana/mcp-grafana -t stdio

SSE 모드로 서버 실행하기

이 모드에서는 서버가 클라이언트가 연결하는 HTTP 서버로 실행됩니다. 포트 8000을 노출해야 해요.

docker pull grafana/mcp-grafana
docker run --rm -p 8000:8000 \
  -e GRAFANA_URL=http://localhost:3000 \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> \
  grafana/mcp-grafana

클라이언트를 http://localhost:8000/sse(또는 여러분의 호스트와 포트)로 연결하세요.

streamable HTTP 모드로 서버 실행하기

이 모드에서는 서버가 여러 클라이언트 연결을 처리할 수 있는 독립 프로세스로 동작합니다. 포트 8000을 노출하고 -t streamable-http를 설정해야 해요.

docker pull grafana/mcp-grafana
docker run --rm -p 8000:8000 \
  -e GRAFANA_URL=http://localhost:3000 \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> \
  grafana/mcp-grafana -t streamable-http

기본 MCP 경로는 /mcp예요(--endpoint-path 참고). 클라이언트는 보통 http://localhost:8000/mcp를 사용합니다.

서버 TLS 인증서로 HTTPS streamable HTTP 모드 실행하기

MCP 서버에서 TLS를 종료하려면 인증서를 마운트하고 --server.tls-cert-file, --server.tls-key-file, --address(예: :8443)를 설정하세요:

docker pull grafana/mcp-grafana
docker run --rm -p 8443:8443 \
  -v /path/to/certs:/certs:ro \
  -e GRAFANA_URL=http://localhost:3000 \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your service account token> \
  grafana/mcp-grafana \
  -t streamable-http \
  --address :8443 \
  --server.tls-cert-file /certs/server.crt \
  --server.tls-key-file /certs/server.key

다음 단계

더 알아보기 (Learn more)