Skip to main content
Glama
yokonao

claude-code-traceparent

by yokonao

claude-code-traceparent PoC

Claude Code が MCP Server へのリクエストに W3C Trace Context を付与するのか検証

セットアップ

bun install

Related MCP server: Echo MCP Server

起動

bun run src/server.ts                  # http(デフォルト)

環境変数

デフォルト

説明

TRANSPORT

http

stdio / http を切替

PORT

3456

HTTP モードの待受ポート

LOG_FILE

debug.log

受信内容を追記するログファイル

echo ツール

引数: message: string

処理: message をエコーバック。_meta / HTTP ヘッダーを解析して traceparent を抽出しデバッグログに残す


確認手順

1. MCP Server の起動

bun run src/server.ts

2. Grafana の起動

OpenTelemetry のトレースを可視化するために Grafana を起動する。

docker run -p 3000:3000 -p 4317:4317 -p 4318:4318 --name lgtm grafana/otel-lgtm

3. Claude Code を起動

claude
# Claude Code 内で確認
> /mcp
> use the echo tool with message "hello"

補足:以下のファイルで OpenTelemetry の有効設定と MCP の登録を行っている

4. 結果の見方

ツール実行後、debug.log / Claude Code のセッション履歴 / Claude Code OTel Traces の突合を確認する

  1. debug.log から trace_id を確認

  2. grafana の Web UI から trace_id で Log や Trace を検索する

  3. grep で Claude Code のセッション履歴ファイルを特定する

trace_id=<YOUR_TRACE_ID>
grep -r $trace_id ~/.claude

5. CLI 単体での疎通確認

サーバ単体の動作だけ確かめたい場合:

# stdio
TP="00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
printf '%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"cli","version":"0"}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"echo","arguments":{"message":"hi"},"_meta":{"traceparent":"'"$TP"'"}}}' \
  | TRANSPORT=stdio bun run src/server.ts

# HTTP(サーバ起動後)
curl -s -X POST http://localhost:3456/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"echo","arguments":{"message":"hi"},"_meta":{"traceparent":"'"$TP"'"}}}'

Maintenance

ActivityStale
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A simple demonstration MCP server that provides an echo tool and resource for learning how to build MCP servers. Serves as a starting point and template for creating custom MCP server implementations.
    1
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    MCP server scaffold that exposes stubbed tools for listing, searching, and summarizing sources, with built-in OAuth 2.1 authorization flow for Claude integration.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Local MCP server for decision trace capture and deterministic explanations, providing tools to start, track, and query decision traces, and resources to retrieve trace data.
    13
    MIT