Skip to main content
Glama
kanchingyg

otel-pocket

by kanchingyg
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Go
Local

otel-pocket

ci npm JSR Go license

One command local OpenTelemetry collector: npx otel-pocket (or bunx otel-pocket) listens on :4318 for OTLP/JSON traces, renders a live terminal flamegraph, flags SQL N+1 loops, and surfaces gen_ai.* LLM spans (Ollama, OpenAI, Anthropic).

Install

Bun / npm:

bunx otel-pocket
npx otel-pocket

# or install in your project / globally
bun add -d otel-pocket
npm i -D otel-pocket

JSR:

bunx jsr add @kanchingyg/otel-pocket
npx jsr add @kanchingyg/otel-pocket

Go (native binary):

go install github.com/kanchingyg/otel-pocket@latest

The core collector runs in Go (main.go, internal/). TypeScript under src/*.ts is included for npx / bunx / JSR usage and MCP bridge helpers.

Related MCP server: tracehub-mcp

Quick start

npx otel-pocket
bunx otel-pocket
# point your SDK exporter to http://127.0.0.1:4318/v1/traces
npx otel-pocket --mcp

Add to Cursor or Claude Code MCP config:

{
  "mcpServers": {
    "otel-pocket": {
      "command": "npx",
      "args": ["-y", "otel-pocket", "--mcp"]
    }
  }
}

MCP tools

Tool

Purpose

list_recent_traces

Recent traces with duration and error status

inspect_trace_tree

Span tree, critical path, N+1 SQL, and gen_ai metrics (SQL redacted unless verbose or OTEL_POCKET_VERBOSE_MCP=1)

diagnose_slow_trace

Ask a local OpenAI-compatible model (Ollama/LM Studio); loopback-only unless OTEL_POCKET_ALLOW_REMOTE_LLM=1

Set OTEL_POCKET_LLM_URL / OTEL_POCKET_LLM_MODEL for local LLM diagnosis.

Why otel-pocket

Jaeger and desktop viewers require a browser, lack a terminal TUI, and do not ship MCP tools for coding agents. Phoenix and Langfuse are heavy Python/Docker stacks. otel-pocket correlates HTTP, SQL N+1, and gen_ai.* spans in a single zero-config npx, bunx, or go install binary.

License

MIT

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • otel-mcp-server

    shiftyp
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language querying and analysis of OpenTelemetry traces, metrics, and logs stored in Elasticsearch/OpenSearch, allowing AI assistants to investigate performance issues, find root causes, and explore system behavior.
    7 npm
    14
    MIT

  • tracehub-mcp

    mcpsmiths
    A
    license
    A
    quality
    A
    maintenance
    Connects AI assistants to OpenTelemetry trace backends such as Jaeger, Tempo, Traceloop, and Datadog, enabling natural-language searching of traces and spans, error discovery, and service listing. It also provides LLM-specific analytics, including token usage aggregation, model performance comparison, and identification of the most expensive or slowest traces.
    19
    373 PyPI
    Apache 2.0

  • mcp-agent-trace-inspector

    dbsectrainer
    A
    license
    A
    quality
    B
    maintenance
    Enables local-first observability for MCP agent workflows by recording tool calls, prompts, latency, and token usage in a local SQLite database, and provides tools for inspecting, comparing, exporting, and generating dashboards from traces.
    13
    13 npm
    MIT

  • Langfuse MCP Server

    williamwebb79986
    F
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents and developers to query traces, sessions, exceptions, prompts, datasets, annotation queues, scores, and metrics for local debugging and observability. Runs locally over stdio or HTTP with selective tool-group loading, read-only mode, and compact or file-dump output to control token usage.
    -