otel-mcp

一个 MCP 服务器，可同时将 OpenTelemetry 追踪、指标和日志发送到一个或多个 OTLP 端点，支持以下三种 OTLP 有线格式中的任意一种：

• 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] 参数。如果省略，则会分发到所有接受该信号类型的端点。

原始信号发送

模拟

内置配置文件：

示例会话

> 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 以确认它已获取参数。

配置文件保持声明式：每个配置文件返回的 span/指标/日志规范都会流经相同的生成器管道，因此它们会自动继承正确的资源合并、有线格式支持和分发功能。