otel-instrumentation-mcp

🥈Silver

Python MCP server providing AI coding assistants with OpenTelemetry documentation, examples, and instrumentation guidance. Benefits developers and operations teams by streamlining observability setup. Connects to AI coding assistants like Claude, Cursor, and Windsurf.

1940Updated 2mo ago

Intermediate30min to implementautomation

Saves ~60 min per use

Quick InstallView Source

git clone https://github.com/liatrio-labs/otel-instrumentation-mcp.git

Works with:

Claude

Overview

About This Skill

The otel-instrumentation-mcp server bridges AI coding assistants like Claude, Cursor, and Windsurf with the OpenTelemetry ecosystem. It provides real-time access to OpenTelemetry repositories, documentation, semantic conventions, examples, and instrumentation scoring specifications. The server helps engineers implement high-quality observability by navigating OpenTelemetry complexity, generating accurate instrumentation code, and following best practices. It supports multiple authentication methods including GitHub Personal Access Tokens and GitHub Apps, and offers self-instrumented distributed tracing with support for stdio, HTTP, and SSE transports.

How to Use

Clone the repository and install dependencies with uv sync. Configure GitHub authentication via GITHUB_TOKEN (PAT) or GitHub App credentials. Run uv run otel-instrumentation-mcp to start the server, then add the configuration to your AI assistant (Claude Desktop, VS Code, Cursor, or Windsurf) to access OpenTelemetry tools and prompts.

Use Cases

Add OpenTelemetry instrumentation to Python Flask applications with AI assistance

Generate language-specific observability code following semantic conventions

Evaluate telemetry quality using instrumentation scoring specifications

Browse OpenTelemetry repositories and search issues within AI coding assistants

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/liatrio-labs/otel-instrumentation-mcp

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I'm working on a [PROJECT_TYPE] for [COMPANY] in the [INDUSTRY] sector. I need help with OpenTelemetry instrumentation. Can you provide Python code examples for [SPECIFIC_USE_CASE] and explain how to implement it using OpenTelemetry?

Example Output

## OpenTelemetry Instrumentation for [SPECIFIC_USE_CASE]

### Python Code Example
```python
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import ConsoleSpanExporter, SimpleSpanProcessor

# Initialize tracing
provider = TracerProvider()
processor = SimpleSpanProcessor(ConsoleSpanExporter())
provider.add_span_processor(processor)
trace.set_tracer_provider(provider)

# Create a tracer
tr = trace.get_tracer(__name__)

# Instrument your code
with tr.start_as_current_span('[SPECIFIC_USE_CASE]_operation') as span:
    # Your code here
    span.set_attribute('project.type', '[PROJECT_TYPE]')
    span.set_attribute('company', '[COMPANY]')
    span.set_attribute('industry', '[INDUSTRY]')
```

### Key Considerations
- Ensure you have the OpenTelemetry Python SDK installed (`pip install opentelemetry-sdk`)
- Adjust the span attributes to include relevant metadata for your use case
- Consider adding error handling and logging within the span
- Explore additional OpenTelemetry features like context propagation and bagage for more complex scenarios