otel-mcp
otel-mcp
OpenTelemetryのトレース、メトリクス、ログを、3つのOTLPワイヤ形式のいずれかで、同時に1つ以上のOTLPエンドポイントに出力するMCPサーバーです。
grpc— OTLP/gRPC (HTTP/2上のprotobuf)http/protobuf— OTLP/HTTP バイナリprotobufhttp/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_ENDPOINTOTEL_EXPORTER_OTLP_PROTOCOL(grpc|http/protobuf|http/json)OTEL_EXPORTER_OTLP_HEADERS(カンマ区切りのk=vペア)OTEL_EXPORTER_OTLP_INSECURE(gRPC TLSの切り替え)
ツール
エンドポイント管理
ツール | 目的 |
| 名前付きOTLP送信先(URL、プロトコル、シグナル、ヘッダーなど)を登録します。 |
| 名前を指定してエンドポイントを削除します。 |
| すべてのエンドポイントを削除します。 |
| 現在のエンドポイントを列挙します。 |
| エンドポイントと利用可能な模倣プロファイルを表示します。 |
エンドポイントは呼び出しごとに選択されます。シグナルを出力するすべてのツールは endpoints: [names] 引数を受け取ります。省略した場合は、そのシグナルタイプを受け入れるすべてのエンドポイントにファンアウトします。
生シグナルの出力
ツール | 入力の形状 |
|
|
|
|
|
|
模倣(Mimicry)
ツール | 目的 |
| すべてのプロファイルとそのパラメータを表示します。 |
| プロファイルを1つ実行し、そのバンドルを一度送信します。 |
| プロファイルをループ実行して、持続的なトラフィックをシミュレートします。 |
組み込みプロファイル:
プロファイル | 外観 |
| HTTPセマンティック規約、アクセスログ、リクエストカウンター、レイテンシヒストグラムを備えたサーバー・スパン。 |
|
|
|
|
| メッセージングセマンティック規約を備えたプロデューサー/コンシューマー・スパン。 |
|
|
| リソース = 完全な |
|
|
セッション例
> 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"}}
]新しい模倣プロファイルの追加
src/otel_mcp/mimics.py内でMimicBundleを返す関数を作成します。同ファイルの末尾にある
PROFILES辞書に登録します。list_mimic_profilesを呼び出して、パラメータが正しく読み込まれたか確認します。
プロファイルは宣言的なままです。それぞれがスパン/メトリック/ログの仕様を返し、それらが同じジェネレーターパイプラインを流れるため、リソースの適切なマージ、ワイヤ形式のサポート、ファンアウトが自動的に継承されます。
Available Tools
11 toolsadd_endpointA
Register an OTLP destination.
Args:
name: Unique identifier used by other tools to target this endpoint.
url: Collector URL. gRPC: host:port or http://host:port.
HTTP: base URL (/v1/traces etc. is appended automatically).
protocol: One of grpc, http/protobuf, http/json.
signals: Subset of traces, metrics, logs. Defaults to all.
headers: Headers added to every request (auth tokens, tenant ids, ...).
insecure: gRPC only — disable TLS.
timeout_seconds: Per-request timeout.
overwrite: If an endpoint with this name already exists, replace it.
Inputs: name (required), url (required), protocol, signals, +4 more. Returns: object
clear_endpointsB
Remove all endpoints.
Inputs: no named parameters. Returns: object
generate_loadA
Repeatedly run a mimic profile to simulate sustained traffic.
Blocks for roughly iterations * interval_seconds seconds. For true
background loops use an external scheduler — this tool is synchronous by
design so the caller sees per-iteration results.
Inputs: profile (required), iterations, interval_seconds, endpoints, +1 more. Returns: object
list_endpointsB
List registered endpoints.
Inputs: no named parameters. Returns: object
list_mimic_profilesB
List available tool-mimicry profiles.
Inputs: no named parameters. Returns: object
mimic_toolB
Emit a realistic bundle of signals mimicking a known tool.
Args:
profile: One of nginx, postgres, redis, kafka,
aws-lambda, k8s-pod, grpc. Call list_mimic_profiles
for profile-specific parameters.
endpoints: Fan-out target endpoints. Defaults to all registered.
options: Keyword args passed to the profile (e.g. {"count": 50}).
Inputs: profile (required), endpoints, options. Returns: object
remove_endpointC
Remove an endpoint by name.
Inputs: name (required). Returns: object
send_logB
Send one or more log records.
Each record dict accepts: body, severity (trace/debug/info/warn/
error/fatal), severity_text, attributes, timestamp_ns.
Inputs: service_name (required), records (required), resource_attributes, endpoints. Returns: object
send_metricB
Send one or more metric instruments.
Each metric dict accepts: name, kind (counter/up_down_counter/gauge/
histogram), unit, description, points (list of
{value, attributes}). For histograms, value may be a list of samples.
Inputs: service_name (required), metrics (required), resource_attributes, endpoints. Returns: object
send_traceA
Send one or more spans to the targeted endpoints.
Each span dict accepts: name, kind (internal/server/client/producer/
consumer), attributes, duration_ms, status (ok/error/unset),
status_message, events (list of {name, attributes}),
parent_name (to nest spans within the same batch).
If endpoints is omitted, fans out to every endpoint that accepts traces.
Inputs: service_name (required), spans (required), resource_attributes, endpoints. Returns: object
statusA
Report configured endpoints and available profiles.
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools like add_endpoint, remove_endpoint, and clear_endpoints handle endpoint management, while send_log, send_metric, and send_trace target specific telemetry signals. Mimic_tool and generate_load are for simulation, and list_endpoints/list_mimic_profiles/status are for querying, all with non-overlapping functions.
All tool names follow a consistent verb_noun pattern using snake_case, such as add_endpoint, list_endpoints, send_log, and mimic_tool. This uniformity makes the set predictable and easy to understand, with no deviations in naming conventions.
With 11 tools, this server is well-scoped for OpenTelemetry management and simulation. It covers endpoint configuration, telemetry emission, mimicry, and status reporting without being overly sparse or bloated, with each tool serving a clear and necessary role.
The tool set provides complete coverage for the OpenTelemetry domain, including CRUD operations for endpoints (add, remove, clear, list), sending all signal types (logs, metrics, traces), simulation capabilities (mimic, generate_load), and querying (status, list profiles). There are no obvious gaps that would hinder agent workflows.
Maintenance
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
Stateless MCP gateway and OTel span-streaming bridge for hosted MCP servers.
Cloud hosted Okahu MCP server that helps you manage genAI trace data
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server implementation that enables dynamic configuration of OpenTelemetry Collectors, allowing users to add, remove, and configure receivers, processors, and exporters through MCP tools.52GPL 3.0
- AlicenseBqualityDmaintenanceA mock MCP server for testing MCP client implementations and development workflows. Supports tools, prompts, and resources across multiple transport protocols (stdio, HTTP, SSE).1MIT
- AlicenseBqualityDmaintenanceMCP server for analyzing OpenTelemetry traces with performance and error diagnosis, supporting loading from files, AWS X-Ray, and CloudWatch.8MIT
- AlicenseAqualityDmaintenanceMCP server that gives AI agents access to your application's OpenTelemetry traces for querying, analysis, and debugging.511 npm2MIT