mcp-victorialogs

VictoriaLogs MCP 서버

느슨하게

VictoriaLogs 에 대한 MCP(Model Context Protocol) 서버 구현.

이를 통해 VictoriaLogs 인스턴스에 대한 접근 권한과 VictoriaLogs API 및 문서 와의 원활한 통합이 제공됩니다. VictoriaLogs 인스턴스와 관련된 로그, 관측 가능성 및 디버깅 작업을 위한 포괄적인 인터페이스를 제공하고, 엔지니어와 도구를 위한 고급 자동화 및 상호 작용 기능을 활성화할 수 있습니다.

특징

이 MCP 서버를 사용하면 VictoriaLogs의 거의 모든 읽기 전용 API, 즉 웹 UI 에서 사용 가능한 모든 기능을 사용할 수 있습니다.

로그 쿼리 및 로그 데이터 탐색
VictoriaLogs 인스턴스의 매개변수 표시
사용 가능한 스트림, 필드, 필드 값 나열
로그에 대한 통계를 메트릭으로 쿼리합니다.

또한 MCP 서버에는 최신 문서가 내장되어 있어 온라인 접속 없이도 검색할 수 있습니다.

사용 가능한 도구와 프롬프트에 대한 자세한 내용은 사용 섹션에서 확인할 수 있습니다.

도구 및 문서 검색 기능을 프롬프트에 통합하고 VictoriaLogs 인스턴스에 대한 훌륭한 사용 시나리오를 만들어낼 수 있습니다. MCP 서버와 그 응답의 품질은 클라이언트의 성능과 사용 중인 모델의 품질에 따라 크게 달라진다는 점에 유의하시기 바랍니다.

MCP 서버를 다른 관찰성 또는 문서 검색 관련 MCP 서버와 결합하여 더욱 강력한 결과를 얻을 수도 있습니다.

요구 사항

VictoriaLogs 인스턴스( 단일 노드 또는 클러스터 )
Go 1.24 이상(소스에서 빌드하려는 경우)

설치

가다

지엑스피1

소스 코드

git clone https://github.com/VictoriaMetrics-Community/mcp-victorialogs.git
cd mcp-victorialogs
go build -o bin/mcp-victorialogs ./cmd/mcp-victorialogs/main.go

# after that add bin/mcp-victorialogs file to your PATH

바이너리

릴리스 페이지에서 최신 릴리스를 다운로드하고 PATH에 추가하세요.

도커

곧 출시됩니다...

대장간

Smithery를 통해 클라이언트에 VictoriaLogs MCP 서버를 자동으로 설치하려면 다음 명령을 사용하면 됩니다.

# Get the list of supported MCP clients
npx -y @smithery/cli list clients
#Available clients:
#  claude
#  cline
#  windsurf
#  roocode
#  witsy
#  enconvo
#  cursor
#  vscode
#  vscode-insiders
#  boltai
#  amazon-bedrock

# Install VictoriaLogs MCP server for your client
npx -y @smithery/cli install @VictoriaMetrics-Community/mcp-victorialogs --client <YOUR-CLIENT-NAME>
# and follow the instructions

구성

VictoriaLogs용 MCP 서버는 환경 변수를 통해 구성됩니다.

변하기 쉬운	설명	필수의	기본	허용된 값
`VL_INSTANCE_ENTRYPOINT`	VictoriaLogs 인스턴스의 URL	예	-	-
`VL_INSTANCE_BEARER_TOKEN`	VictoriaLogs API에 대한 인증 토큰	아니요	-	-
`MCP_SERVER_MODE`	서버 작동 모드	아니요	`stdio`	`stdio` , `sse`
`MCP_SSE_ADDR`	SSE 서버가 수신할 주소	아니요	`:8081`	-

구성 예

# For a public playground
export VL_INSTANCE_ENTRYPOINT="https://play-vmlogs.victoriametrics.com"

# Server mode
export MCP_SERVER_MODE="sse"
export MCP_SSE_ADDR="0.0.0.0:8081"

클라이언트 설정

커서

Settings -> Cursor Settings -> MCP -> Add new global MCP server 로 이동하여 다음 구성을 커서 ~/.cursor/mcp.json 파일에 붙여넣습니다.

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

자세한 내용은 커서 MCP 문서를 참조하세요.

클로드 데스크탑

Claude Desktop claude_desktop_config.json 파일에 다음을 추가합니다( Settings -> Developer -> Edit config 열면 찾을 수 있습니다).

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

자세한 내용은 Claude Desktop MCP 문서를 참조하세요.

클로드 코드

다음 명령을 실행합니다.

claude mcp add victorialogs -- /path/to/mcp-victorialogs \
  -e VL_INSTANCE_ENTRYPOINT=<YOUR_VL_INSTANCE> \
  -e VL_INSTANCE_BEARER_TOKEN=<YOUR_VL_BEARER_TOKEN>

자세한 내용은 Claude Code MCP 문서를 참조하세요.

비주얼 스튜디오 코드

VS Code MCP 구성 파일에 다음을 추가하세요.

{
  "servers": {
    "victorialogs": {
      "type": "stdio",
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

자세한 내용은 VS Code MCP 문서를 참조하세요.

제드 자의 명칭

Zed 구성 파일에 다음을 추가하세요.

  "context_servers": {
    "victorialogs": {
      "command": {
        "path": "/path/to/mcp-victorialogs",
        "args": [],
        "env": {
          "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
          "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
        }
      },
      "settings": {}
    }
  }
}

자세한 내용은 Zed MCP 문서를 참조하세요.

JetBrains IDE

Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP) 엽니다.
Add (+) 클릭하세요
As JSON 선택
입력 필드에 다음을 입력하세요.

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

윈드서핑

Windsurf MCP 구성 파일에 다음을 추가하세요.

{
  "mcpServers": {
    "victorialogs": {
      "command": "/path/to/mcp-victorialogs",
      "env": {
        "VL_INSTANCE_ENTRYPOINT": "<YOUR_VL_INSTANCE>",
        "VL_INSTANCE_BEARER_TOKEN": "<YOUR_VL_BEARER_TOKEN>"
      }
    }
  }
}

자세한 내용은 Windsurf MCP 문서를 참조하세요.

아마존 베드락

곧 출시됩니다....

바이너리 대신 Docker 사용

곧 출시됩니다...

용법

MCP 서버를 설치 하고 구성한 후에는 원하는 MCP 클라이언트와 함께 사용할 수 있습니다.

다음 문구를 통해 AI 도우미와 대화를 시작할 수 있습니다.

Use MCP VictoriaLogs in the following answers

하지만 꼭 필요한 것은 아닙니다. 질문을 하기만 하면 도우미가 자동으로 도구와 문서를 활용해 가장 적절한 답변을 제공합니다.

도구 세트

MCP VictoriaLogs는 VictoriaLogs 인스턴스와 상호작용하기 위한 다양한 도구를 제공합니다.

사용 가능한 도구 목록은 다음과 같습니다.

도구	설명
`documentation`	내장된 VictoriaLogs 문서에서 검색
`facets`	각 로그 필드당 가장 빈번한 값
`field_names`	쿼리에 대한 필드 이름 목록
`field_values`	쿼리에 대한 필드 값 목록
`flags`	VictoriaLogs 인스턴스의 기본이 아닌 플래그 보기
`hits`	버킷별로 그룹화된 일치하는 로그 항목 수
`query`	LogsQL 쿼리 실행
`stats_query`	지정된 시간에 대한 로그 통계 쿼리
`stats_query_range`	지정된 시간 범위에 대한 로그 통계 쿼리
`stream_field_names`	쿼리에 대한 스트림 필드 목록
`stream_field_names`	쿼리에 대한 스트림 필드 값 목록
`stream_ids`	쿼리에 대한 스트림 ID 목록
`streams`	쿼리에 대한 스트림 목록

프롬프트

서버에는 일반적인 작업에 대한 미리 정의된 프롬프트가 포함되어 있습니다.

현재는 단지 예시일 뿐이며, 프롬프트 라이브러리는 앞으로 추가될 예정입니다.

즉각적인	설명
`documentation`	특정 주제에 대한 VictoriaLogs 문서 검색

부인 성명

이러한 MCP 서버와 함께 제공되는 AI 서비스 및 에이전트는 결과의 정확성, 완전성 및 신뢰성을 보장할 수 없습니다. AI를 통해 얻은 결과를 다시 한번 확인해야 합니다. MCP 서버와 그 응답의 품질은 클라이언트의 성능과 사용 중인 모델의 품질에 따라 크게 달라집니다.

기여하다

MCP VictoriaLogs 프로젝트에 대한 기여를 환영합니다! 이슈, 기능 요청 또는 풀 리퀘스트를 자유롭게 제출해 주세요.