otel-mcp

OpenTelemetryのトレース、メトリクス、ログを、3つのOTLPワイヤ形式のいずれかで、同時に1つ以上の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] 引数を受け取ります。省略した場合は、そのシグナルタイプを受け入れるすべてのエンドポイントにファンアウトします。

生シグナルの出力

模倣（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 を呼び出して、パラメータが正しく読み込まれたか確認します。

プロファイルは宣言的なままです。それぞれがスパン/メトリック/ログの仕様を返し、それらが同じジェネレーターパイプラインを流れるため、リソースの適切なマージ、ワイヤ形式のサポート、ファンアウトが自動的に継承されます。