Gemini CLI

Gemini CLI

이 가이드는 Google Gemini CLI용 mcp-grafana 서버를 설정하는 방법을 안내해요.

출처: 문서

본문

전제 조건

  • Gemini CLI 설치(npm install -g @google/gemini-cli)
  • 서비스 계정 토큰이 있는 Grafana 9.0+
  • PATH에 있는 mcp-grafana 바이너리

구성

Gemini CLI는 MCP 구성을 ~/.gemini/settings.json에 저장해요.

수동 구성

~/.gemini/settings.json을 만들거나 편집해요:

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

CLI 명령어

# 구성된 서버 나열
gemini mcp list

# 서버 제거
gemini mcp remove grafana

Docker 구성

{
  "mcpServers": {
    "grafana": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "GRAFANA_URL",
        "-e",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN",
        "grafana/mcp-grafana",
        "-t",
        "stdio"
      ],
      "env": {
        "GRAFANA_URL": "http://host.docker.internal:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

디버그 모드

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

구성 검증

  1. Gemini CLI를 시작해요:
gemini
  1. /mcp를 실행해 사용 가능한 도구를 확인해요.
  2. "내 Grafana 대시보드를 나열해 줘"라고 물어봐요.

SSE 전송 (원격 서버)

HTTP 기반 연결의 경우:

  1. mcp-grafana를 HTTP 서버로 시작해요:
export GRAFANA_URL="http://localhost:3000"
export GRAFANA_SERVICE_ACCOUNT_TOKEN="<your-token>"
mcp-grafana --transport sse --address localhost:8000
  1. settings.json에서 구성해요:
{
  "mcpServers": {
    "grafana": {
      "httpUrl": "http://localhost:8000/sse"
    }
  }
}

문제 해결

도구가 나타나지 않음:

  • Gemini CLI에서 /mcp를 실행해 등록된 도구를 확인해요.
  • settings.json 구문을 확인해요.
  • 바이너리 경로 확인: which mcp-grafana

연결 오류:

  • GRAFANA_URL에 접근 가능한지 확인해요.
  • Grafana에서 토큰 권한을 확인해요.

읽기 전용 모드

{
  "mcpServers": {
    "grafana": {
      "command": "mcp-grafana",
      "args": ["--disable-write"],
      "env": {
        "GRAFANA_URL": "http://localhost:3000",
        "GRAFANA_SERVICE_ACCOUNT_TOKEN": "<your-token>"
      }
    }
  }
}

다음 단계