otel-mcp

OpenTelemetry 트레이스, 메트릭 및 로그를 세 가지 OTLP 와이어 형식 중 하나로, 동시에 하나 이상의 OTLP 엔드포인트로 전송하는 MCP 서버입니다:

• grpc — OTLP/gRPC (HTTP/2 기반 protobuf)

• http/protobuf — OTLP/HTTP 바이너리 protobuf

• http/json — OTLP/HTTP proto3-JSON (사양 준수)

또한 잘 알려진 도구(nginx, postgres, redis, kafka, aws-lambda, kubernetes pod, 일반 gRPC 서비스)와 유사한 형태의 현실적인 신호 번들을 생성하는 도구 모방 프로필을 제공하므로, 실제 환경과 유사한 트래픽으로 수집기나 백엔드를 채울 수 있습니다.

설치

uv venv
uv pip install -e .

Related MCP server: Mock MCP Server

실행

otel-mcp           # stdio transport — wire into any MCP client

또는 MCP 클라이언트 설정(예: Claude Desktop, Claude Code)을 통해 실행:

{
  "mcpServers": {
    "otel": {
      "command": "otel-mcp"
    }
  }
}

환경 변수 부트스트랩

실행 시 OTEL_EXPORTER_OTLP_ENDPOINT가 설정되어 있으면, 표준 OTEL 환경 변수를 사용하여 default라는 이름의 엔드포인트가 등록됩니다:

• OTEL_EXPORTER_OTLP_ENDPOINT

• OTEL_EXPORTER_OTLP_PROTOCOL (grpc | http/protobuf | http/json)

• OTEL_EXPORTER_OTLP_HEADERS (쉼표로 구분된 k=v 쌍)

• OTEL_EXPORTER_OTLP_INSECURE (gRPC TLS 토글)

도구

엔드포인트 관리

엔드포인트는 호출별로 선택됩니다: 모든 신호 전송 도구는 endpoints: [names] 인수를 허용합니다. 이를 생략하면 해당 신호 유형을 허용하는 모든 엔드포인트로 전송(fan-out)됩니다.

원시 신호 전송

모방(Mimicry)

내장 프로필:

예시 세션

> add_endpoint name="otel-collector" url="http://localhost:4318" protocol="http/protobuf"
> add_endpoint name="jaeger-json"    url="http://localhost:4318" protocol="http/json" signals=["traces"]
> mimic_tool profile="nginx" options={"count": 50, "error_rate": 0.1}
> mimic_tool profile="postgres"
> generate_load profile="kafka" iterations=10 interval_seconds=2
> send_trace service_name="checkout" spans=[
    {"name": "POST /checkout", "kind": "server", "duration_ms": 42, "attributes": {"http.response.status_code": 200}},
    {"name": "charge_card",    "kind": "client", "parent_name": "POST /checkout", "duration_ms": 18,
     "attributes": {"peer.service": "stripe"}}
  ]

새로운 모방 프로필 추가

1. src/otel_mcp/mimics.py에서 MimicBundle을 반환하는 함수를 작성합니다.

2. 해당 파일 하단의 PROFILES 딕셔너리에 등록합니다.

3. list_mimic_profiles를 호출하여 매개변수가 제대로 인식되었는지 확인합니다.

프로필은 선언적으로 유지됩니다: 각 프로필은 동일한 생성기 파이프라인을 통과하는 스팬/메트릭/로그 사양을 반환하므로, 올바른 리소스 병합, 와이어 형식 지원 및 팬아웃을 자동으로 상속받습니다.