Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

[bot] MCP (Model Context Protocol) Python SDK: no instrumentation for ClientSession tool-calling execution

Ouverte
  • Quelque chose ne va pas ?
#567 1 commentaire 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@raoashish10 y travaille déjà.

Depuis le 2/8/2026.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
48/100
Type d'issue
Fonctionnalité
Clarté
Plutôt claire
Activité
Calme
Stack technique
python
Domaine
observability-sre

Piste de recherche

Commencez par py/src/braintrust/integrations/adk/test_adk_mcp_tool.py et la structure environnante de py/src/braintrust/integrations/, puisque le dépôt ne contient pas d’intégration mcp autonome. Examinez les surfaces stables de mcp.ClientSession listées dans l’issue ainsi que les conventions de tracing existantes ; le travail est considéré comme terminé lorsque les appels directs aux outils, les lectures de ressources et les opérations sur les prompts sont instrumentés avec les entrées, sorties et métadonnées indiquées, et que le tableau des intégrations du README a été mis à jour.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

bot-automation

Summary

The official Model Context Protocol Python SDK (PyPI package mcp, https://github.com/modelcontextprotocol/python-sdk) is not instrumented anywhere in this repo. mcp.ClientSession exposes an execution surface for agent tool-calling — call_tool(), list_tools(), read_resource(), list_resources(), list_prompts(), get_prompt() — that a developer's own agent code can call directly, independent of any of the agent frameworks this repo already instruments (claude_agent_sdk, openai_agents, google-adk, etc., which each embed their own MCP client internally).

Braintrust already instruments several agent-run frameworks that use MCP under the hood (e.g. Google ADK — see py/src/braintrust/integrations/adk/test_adk_mcp_tool.py — plus Claude Agent SDK and OpenAI Agents SDK), but a developer who talks to an MCP server directly via the standalone mcp SDK (not through one of those frameworks) gets zero tracing for their tool calls, resource reads, or prompt fetches.

Braintrust docs status: not_found. https://www.braintrust.dev/docs/guides/tracing lists supported providers ("OpenAI, Anthropic, Gemini, AWS Bedrock, Azure, Mistral, Together, Groq, and many more") and frameworks ("LangChain, LangGraph, CrewAI, Vercel AI SDK, Pydantic AI, DSPy, and many more") but does not mention the standalone MCP Python SDK or ClientSession instrumentation.

What needs to be instrumented

SDK surface Already traced?
ClientSession.call_tool(name, arguments) No
ClientSession.list_tools() No
ClientSession.read_resource(uri) No
ClientSession.list_resources() No
ClientSession.get_prompt(name, arguments) No

A useful span for call_tool should record input (tool name + arguments), output (CallToolResult.content / structuredContent), and metadata (provider: "mcp", server name/transport).

Upstream sources

Local repo files inspected

  • Repo-wide grep for import mcp, from mcp, ClientSession under py/src/braintrust/ — zero matches
  • py/src/braintrust/integrations/adk/test_adk_mcp_tool.py — MCP only exercised as a sub-feature of the Google ADK integration; no standalone mcp patcher
  • py/src/braintrust/integrations/ — no mcp/ directory
  • README.md integrations table — no MCP entry

Note: as of this writing the mcp package's v2 line (2.0.0b1) is an explicit pre-release not intended for production per its own README, so instrumentation should target the stable v1.x ClientSession API.

Langage dominant
Python
Étoiles
21
Forks
23
Merge moyen
19 h 55 min
PR mergées (30 j)
95

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de braintrustdata/braintrust-sdk-python

Toutes les issues de braintrustdata/braintrust-sdk-python

Issues similaires

Plus d'issues Python

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.