Add OpenTelemetry instrumentation for MCP (Model Context Protocol)

This commit adds automatic instrumentation for the Model Context Protocol,
enabling distributed tracing for MCP client and server operations.

Key Features:
- Automatic tracing for MCP client requests and notifications
- Automatic tracing for MCP server request/notification handlers
- Distributed trace context propagation via W3C Trace Context
- Support for both stdio and HTTP transports
- MCP semantic conventions support
- Session ID tracking for HTTP transport

Implementation:
- Instruments BaseSession.send_request/send_notification (client-side)
- Instruments Server._handle_request/_handle_notification (server-side)
- Injects/extracts trace context via params._meta field
- Creates linked spans for distributed tracing

Code Quality:
- 58 comprehensive unit tests (100% pass rate)
- Lint score: 10.00/10
- Passes all pre-commit hooks
- Full type annotations and documentation

Package: opentelemetry-instrumentation-mcp
Location: instrumentation-genai/opentelemetry-instrumentation-mcp/
Dependencies: mcp >= 1.8.1

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