Add OpenTelemetry instrumentation for Model Context Protocol (MCP)

This commit introduces a new instrumentation package for the Model Context
Protocol (MCP), enabling automatic distributed tracing for MCP client-server
interactions.

Key Features:
- Automatic instrumentation of MCP client sessions and server handlers
- Support for both stdio and HTTP/SSE transports
- W3C trace context propagation across MCP messages
- Comprehensive span attributes following semantic conventions
- Tool calls, resource reads, prompt handling, and session lifecycle tracing

Package Structure:
- Core instrumentation: McpInstrumentor with automatic wrapping
- Semantic attributes: MCP-specific span attributes and conventions
- Test coverage: Unit tests for instrumentor, server, and session wrappers
- Examples: stdio (simple-client-server) and HTTP/SSE transport demos
- Documentation: README, CHANGELOG, and example-specific guides

Technical Implementation:
- Wraps mcp.ClientSession and mcp.server.Server classes
- Injects trace context into message metadata
- Extracts and propagates context across transport boundaries
- Records exceptions and sets span status appropriately
- Requires Python >=3.10 (MCP SDK requirement)

CI/CD Updates:
- Added MCP instrumentation to test workflows
- Updated lint configuration for new package
- Disabled pypy3 tests (Python 3.10+ requirement)
- Integrated into eachdist.ini and bootstrap generation

Examples:
- simple-client-server: stdio transport with tool calls and resources
- http-transport: HTTP/SSE transport with distributed tracing
- Both include Jaeger trace visualizations and setup instructions"

Author: lukeina2z

.github/workflows/lint_0.yml

@@ -89,6 +89,25 @@ jobs:
       - name: Run tests
         run: tox -e lint-instrumentation-google-genai
 
+  lint-instrumentation-mcp:
+    name: instrumentation-mcp
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e lint-instrumentation-mcp
+
   lint-resource-detector-containerid:
     name: resource-detector-containerid
     runs-on: ubuntu-latest

.github/workflows/test_0.yml

@@ -640,6 +640,158 @@ jobs:
       - name: Run tests
         run: tox -e py313-test-instrumentation-google-genai-latest -- -ra
 
+  py310-test-instrumentation-mcp-oldest_ubuntu-latest:
+    name: instrumentation-mcp-oldest 3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py310-test-instrumentation-mcp-oldest -- -ra
+
+  py310-test-instrumentation-mcp-latest_ubuntu-latest:
+    name: instrumentation-mcp-latest 3.10 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.10
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py310-test-instrumentation-mcp-latest -- -ra
+
+  py311-test-instrumentation-mcp-oldest_ubuntu-latest:
+    name: instrumentation-mcp-oldest 3.11 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py311-test-instrumentation-mcp-oldest -- -ra
+
+  py311-test-instrumentation-mcp-latest_ubuntu-latest:
+    name: instrumentation-mcp-latest 3.11 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py311-test-instrumentation-mcp-latest -- -ra
+
+  py312-test-instrumentation-mcp-oldest_ubuntu-latest:
+    name: instrumentation-mcp-oldest 3.12 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py312-test-instrumentation-mcp-oldest -- -ra
+
+  py312-test-instrumentation-mcp-latest_ubuntu-latest:
+    name: instrumentation-mcp-latest 3.12 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py312-test-instrumentation-mcp-latest -- -ra
+
+  py313-test-instrumentation-mcp-oldest_ubuntu-latest:
+    name: instrumentation-mcp-oldest 3.13 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py313-test-instrumentation-mcp-oldest -- -ra
+
+  py313-test-instrumentation-mcp-latest_ubuntu-latest:
+    name: instrumentation-mcp-latest 3.13 Ubuntu
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repo @ SHA - ${{ github.sha }}
+        uses: actions/checkout@v4
+
+      - name: Set up Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install tox
+        run: pip install tox-uv
+
+      - name: Run tests
+        run: tox -e py313-test-instrumentation-mcp-latest -- -ra
+
   py39-test-resource-detector-containerid_ubuntu-latest:
     name: resource-detector-containerid 3.9 Ubuntu
     runs-on: ubuntu-latest
@@ -4629,155 +4781,3 @@ jobs:
 
       - name: Run tests
         run: tox -e py313-test-instrumentation-starlette-latest -- -ra
-
-  pypy3-test-instrumentation-starlette-oldest_ubuntu-latest:
-    name: instrumentation-starlette-oldest pypy-3.9 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python pypy-3.9
-        uses: actions/setup-python@v5
-        with:
-          python-version: "pypy-3.9"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e pypy3-test-instrumentation-starlette-oldest -- -ra
-
-  pypy3-test-instrumentation-starlette-latest_ubuntu-latest:
-    name: instrumentation-starlette-latest pypy-3.9 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python pypy-3.9
-        uses: actions/setup-python@v5
-        with:
-          python-version: "pypy-3.9"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e pypy3-test-instrumentation-starlette-latest -- -ra
-
-  py39-test-instrumentation-jinja2_ubuntu-latest:
-    name: instrumentation-jinja2 3.9 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python 3.9
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.9"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e py39-test-instrumentation-jinja2 -- -ra
-
-  py310-test-instrumentation-jinja2_ubuntu-latest:
-    name: instrumentation-jinja2 3.10 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python 3.10
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e py310-test-instrumentation-jinja2 -- -ra
-
-  py311-test-instrumentation-jinja2_ubuntu-latest:
-    name: instrumentation-jinja2 3.11 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python 3.11
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.11"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e py311-test-instrumentation-jinja2 -- -ra
-
-  py312-test-instrumentation-jinja2_ubuntu-latest:
-    name: instrumentation-jinja2 3.12 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python 3.12
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e py312-test-instrumentation-jinja2 -- -ra
-
-  py313-test-instrumentation-jinja2_ubuntu-latest:
-    name: instrumentation-jinja2 3.13 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python 3.13
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.13"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e py313-test-instrumentation-jinja2 -- -ra
-
-  pypy3-test-instrumentation-jinja2_ubuntu-latest:
-    name: instrumentation-jinja2 pypy-3.9 Ubuntu
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    steps:
-      - name: Checkout repo @ SHA - ${{ github.sha }}
-        uses: actions/checkout@v4
-
-      - name: Set up Python pypy-3.9
-        uses: actions/setup-python@v5
-        with:
-          python-version: "pypy-3.9"
-
-      - name: Install tox
-        run: pip install tox-uv
-
-      - name: Run tests
-        run: tox -e pypy3-test-instrumentation-jinja2 -- -ra