otel-mcp

MCP-сервер, который отправляет трассировки, метрики и логи OpenTelemetry на один или несколько OTLP-эндпоинтов одновременно, используя любой из трех форматов передачи OTLP:

• grpc — OTLP/gRPC (protobuf поверх HTTP/2)

• http/protobuf — OTLP/HTTP бинарный protobuf

• http/json — OTLP/HTTP proto3-JSON (соответствует спецификации)

Он также поставляется с профилями имитации инструментов, которые создают реалистичные наборы сигналов, имитирующие известные инструменты (nginx, postgres, redis, kafka, aws-lambda, под kubernetes, универсальный 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, регистрируется эндпоинт с именем default, использующий стандартные переменные окружения OTEL:

• OTEL_EXPORTER_OTLP_ENDPOINT

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

• OTEL_EXPORTER_OTLP_HEADERS (пары k=v, разделенные запятыми)

• OTEL_EXPORTER_OTLP_INSECURE (переключатель TLS для gRPC)

Инструменты

Управление эндпоинтами

Эндпоинты выбираются для каждого вызова: каждый инструмент, генерирующий сигналы, принимает аргумент endpoints: [names]. Если его опустить, сигнал будет отправлен на все эндпоинты, поддерживающие данный тип сигнала.

Отправка необработанных сигналов

Имитация

Встроенные профили:

Пример сессии

> 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. Напишите функцию, возвращающую MimicBundle в src/otel_mcp/mimics.py.

2. Зарегистрируйте её в словаре PROFILES в конце этого файла.

3. Вызовите list_mimic_profiles, чтобы убедиться, что параметры были подхвачены.

Профили остаются декларативными: каждый из них возвращает спецификации спанов/метрик/логов, которые проходят через тот же конвейер генерации, поэтому они автоматически наследуют корректное объединение ресурсов, поддержку форматов передачи и веерную рассылку.