Inline $ref in tool inputSchema for LLM consumption (parity with typescript-sdk)

オープン

#2,384 2026年4月2日に作成コメント 2 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 3/5
見積もり時間: 1〜2日
初心者へのやさしさ: 68/100

issue の種類: バグ
明瞭さ: おおむね明確
活発さ: 静か
技術スタック: python
領域: api

調査の方向性

src/mcp/server/mcpserver/tools/base.py:76 から確認してください。ここでは model_json_schema() がツールスキーマのパイプラインに渡されています。TypeScript SDK の dereferenceLocalRefs アプローチを、示されている Go SDK の先例と比較してください。ツールスキーマについてローカルの $ref/$defs がインライン化され、循環がエラーになることが完了の条件です。

索引モデルが issue の本文から書いたものです。

説明

enhancement needs decision P2

tools/base.py:76 uses raw model_json_schema() which emits $ref/$defs for nested Pydantic models. LLM clients consuming tools/list often can't resolve $ref, leading to params being passed as stringified JSON instead of structured objects.

Repro / demand: anthropics/claude-code#18260 (Notion MCP server, $ref params get stringified by the model).

typescript-sdk addresses this in modelcontextprotocol/typescript-sdk#1563 by adding a dereferenceLocalRefs() step that inlines local $ref and throws on cycles (matching go-sdk precedent). Python should do the equivalent in the tool schema pipeline so all SDKs emit LLM-consumable schemas.

Relevant file: src/mcp/server/mcpserver/tools/base.py:76

主要言語: Python
スター: 24.3k
フォーク: 4k
平均マージ: 1日 19分
マージ済み PR（30日）: 29

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

modelcontextprotocol/python-sdk のほかの issue

Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) オープン

v1 v2

難易度 2/5 1〜3時間初心者へのやさしさ 85/100

modelcontextprotocol/python-sdk#3546 · コメント 5 件 · 2026年9月19日に作成
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) オープン

v1 v2

難易度 2/5 1〜3時間初心者へのやさしさ 76/100

modelcontextprotocol/python-sdk#3545 · コメント 1 件 · 2026年9月18日に作成
Revocation requires client_secret to be present オープン

v1 v2

難易度 1/5 1時間未満初心者へのやさしさ 91/100

modelcontextprotocol/python-sdk#3508 · コメント 2 件 · 2026年9月15日に作成
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? オープン

難易度 2/5 1〜3時間初心者へのやさしさ 64/100

modelcontextprotocol/python-sdk#3504 · 2026年9月15日に作成
Streamable HTTP stateless servers hang clients on the listen-mode GET (_handle_get_request opens a hold-open SSE stream) オープン

v1 v2

難易度 2/5 1〜3時間初心者へのやさしさ 82/100

modelcontextprotocol/python-sdk#3492 · コメント 1 件 · 2026年9月11日に作成

modelcontextprotocol/python-sdk の issue をすべて見る

似ている issue

[bug] clean-merge parity integration fixtures fail the current approval gate オープン

from:qa priority:P2 reliability tech-debt

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

spec-kitty/spec-kitty#4874 · 2026年9月21日に作成
Update contributor page in the docs オープン

fix: inaccuracy ⚠️

難易度 2/5 1〜3時間初心者へのやさしさ 72/100

uabrc/uabrc.github.io#1255 · コメント 1 件 · 2026年9月21日に作成
[Task SDK] `BaseOperator.post_execute` is invoked without the `result` argument in the new task runner オープン

kind:bug needs-triage

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

apache/airflow#73471 · コメント 1 件 · 2026年9月21日に作成
Use name macOS not darwin in release table オープン

docs

難易度 1/5 1時間未満初心者へのやさしさ 85/100

visit-dav/visit#21164 · 2026年9月21日に作成
melange/apko: attest-build-provenance always fails on fork PRs (missing id-token) オープン

難易度 2/5 1〜3時間初心者へのやさしさ 84/100

ethereum-optimism/factory#64 · 2026年9月21日に作成

Python の issue をもっと見る