VS Code 및 GitHub Copilot

VS Code 및 GitHub Copilot (VS Code and GitHub Copilot)

이 가이드는 GitHub Copilot 에이전트 모드가 있는 VS Code에서 mcp-grafana 서버를 설정하는 방법을 안내해요.

출처: 문서

본문

전제 조건

  • GitHub Copilot 확장이 설치된 VS Code
  • 서비스 계정 토큰이 있는 Grafana 9.0+
  • 설치된 mcp-grafana 바이너리

중요

VS Code의 GitHub Copilot은 stdio가 아닌 SSE 전송을 사용해요. mcp-grafana를 HTTP 서버로 실행해야 해요.

설정

1. MCP 서버 시작

export GRAFANA_URL="http://localhost:3000"
export GRAFANA_SERVICE_ACCOUNT_TOKEN="<your-token>"
mcp-grafana --transport sse --address localhost:8000

또는 Docker로:

docker run --rm -p 8000:8000 \
  -e GRAFANA_URL=http://host.docker.internal:3000 \
  -e GRAFANA_SERVICE_ACCOUNT_TOKEN=<your-token> \
  grafana/mcp-grafana --transport sse --address :8000

2. VS Code 구성

VS Code 설정(settings.json)에 다음을 추가해요:

{
  "github.copilot.chat.mcpServers": {
    "grafana": {
      "url": "http://localhost:8000/sse"
    }
  }
}

또는 프로젝트별 구성에는 워크스페이스 설정(.vscode/settings.json)을 사용해요.

디버그 모드

디버그 로깅으로 서버를 시작해요:

mcp-grafana --transport sse --address localhost:8000 -debug

구성 검증

  1. 구성 변경 후 VS Code를 다시 시작해요.
  2. Copilot Chat을 열어요(Ctrl+Shift+I).
  3. @grafana list dashboards라고 입력해요.
  4. 도구를 사용할 수 있으면 Copilot이 Grafana를 조회해요.

문제 해결

서버가 연결되지 않음:

  • 서버가 실행 중인지 확인해요: curl http://localhost:8000/sse
  • 방화벽이 포트 8000을 허용하는지 확인해요.
  • 구성 변경 후 VS Code를 다시 시작해요.

도구가 나타나지 않음:

  • GitHub Copilot 에이전트 모드가 필요해요(Copilot Chat 활성화가 필요할 수 있어요).
  • VS Code 출력 패널에서 MCP 오류를 확인해요.

서비스로 실행

영구 서버가 필요하면 systemd 유닛 또는 launchd plist를 만들어요.

Linux systemd(~/.config/systemd/user/mcp-grafana.service):

[Unit]
Description=Grafana MCP Server
After=network.target

[Service]
ExecStart=/path/to/mcp-grafana --transport sse --address localhost:8000
Environment=GRAFANA_URL=http://localhost:3000
Environment=GRAFANA_SERVICE_ACCOUNT_TOKEN=<your-token>
Restart=always

[Install]
WantedBy=default.target

다음으로 활성화해요:

systemctl --user enable --now mcp-grafana

읽기 전용 모드

mcp-grafana --transport sse --address localhost:8000 --disable-write

다음 단계