modelcontextprotocol/python-sdk

在 GitHub 查看

The official Python SDK for Model Context Protocol servers and clients

星标: 24.3k
派生: 4k
开放的新手 issue: 17
已索引 issue: 241
平均合并: 1 天 1 小时
30 天内合并 PR: 31

主要语言: Python
许可证: MIT
最近 GitHub push: 2026年9月16日
最近索引: 2026年9月20日
贡献指南: 贡献指南
行为准则: 行为准则
新手标签: good first issue help wanted

适合新手全部

未关闭全部

目前已索引 241 个未关闭的 Issue

Requests with "id": null silently misclassified as notifications 未关闭

bug improves spec compliance P2

难度 3/5 1-2 天新手友好度 48/100

modelcontextprotocol/python-sdk#2057 · 10 条评论 · 1 个 reaction · 2026年2月14日创建
Replace Field(description=...) with proper docstrings in auth models 未关闭

auth enhancement v2

难度 3/5 1-2 天新手友好度 52/100

modelcontextprotocol/python-sdk#2053 · 1 条评论 · 2026年2月13日创建
Audit MCPServer constructor parameters 未关闭

enhancement v2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#2052 · 1 条评论 · 2026年2月13日创建
Refactor handler context to be transport- and handler-type-aware 未关闭

P1 v2

难度 5/5 一周以上新手友好度 25/100

modelcontextprotocol/python-sdk#2021 · 1 条评论 · 2026年2月9日创建
find_context_parameter() fails to detect Context parameter in callable class instances 未关闭

bug P3 v2

难度 2/5 1-3 小时新手友好度 55/100

modelcontextprotocol/python-sdk#1974 · 1 条评论 · 2026年1月30日创建
Per-Request Transport Configuration for MCP Clients 未关闭

documentation enhancement v2

难度 5/5 一周以上新手友好度 38/100

modelcontextprotocol/python-sdk#1966 · 2 条评论 · 1 个 reaction · 2026年1月27日创建
Using transport="stdio" closes real stdio, causing ValueError after server exits 未关闭

bug good first issue P3

难度 2/5 1-3 小时新手友好度 68/100

modelcontextprotocol/python-sdk#1933 · 8 条评论 · 2026年1月22日创建
Trailing slash in OAuthMetadata's `issuer` causes issues with clients 未关闭

auth bug P1 ready for work

难度 3/5 1-2 天新手友好度 58/100

modelcontextprotocol/python-sdk#1919 · 5 条评论 · 1 个 reaction · 2026年1月21日创建
Bug: String parameters starting with digits coerced to numbers, causing UUID data loss 未关闭

bug P2 ready for work

难度 3/5 1-2 天新手友好度 65/100

modelcontextprotocol/python-sdk#1873 · 4 条评论 · 2026年1月15日创建
ClientAuthenticator ignores token_endpoint_auth_method="none" when client_secret is stored 未关闭

auth bug needs confirmation needs decision P2

难度 2/5 1-3 小时新手友好度 72/100

modelcontextprotocol/python-sdk#1842 · 6 条评论 · 2026年1月8日创建
Clarify JSON-RPC error code for 'session not found' responses 未关闭

enhancement improves spec compliance needs decision P2 pending SEP approval v2

难度 5/5 一周以上新手友好度 25/100

modelcontextprotocol/python-sdk#1821 · 2025年12月31日创建
client's `read_stream_writer` open after SSE disconnection hanging `.receive()` 未关闭

bug P1 ready for work

难度 3/5 1-2 天新手友好度 42/100

modelcontextprotocol/python-sdk#1811 · 3 条评论 · 2025年12月21日创建
More control over stderr in stdio client 未关闭

enhancement needs decision P3

难度 2/5 1-3 小时新手友好度 68/100

modelcontextprotocol/python-sdk#1806 · 1 条评论 · 2025年12月19日创建
Possible ressource leak / race condition in streamable_http_client 未关闭

bug needs confirmation

难度 4/5 3-5 天新手友好度 45/100

modelcontextprotocol/python-sdk#1805 · 10 条评论 · 2 个 reaction · 2025年12月19日创建
Implement server-side support for Client ID Metadata Documents (CIMD) 未关闭

auth enhancement needs decision P2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#1801 · 3 条评论 · 2025年12月18日创建
Make JSON-RPC ID type coercion configurable 未关闭

bug P3 v2

难度 4/5 3-5 天新手友好度 45/100

modelcontextprotocol/python-sdk#1795 · 2 条评论 · 2025年12月17日创建
Remove jsonschema dependency 未关闭

enhancement P3 v2

难度 3/5 1-2 天新手友好度 48/100

modelcontextprotocol/python-sdk#1745 · 1 条评论 · 2025年12月5日创建
Improve exception tracebacks for easier debugging 未关闭

enhancement P2 v2

难度 4/5 3-5 天新手友好度 35/100

modelcontextprotocol/python-sdk#1744 · 1 条评论 · 2025年12月5日创建
Extract OAuth flow logic into reusable components for proxy use cases 未关闭

auth enhancement P1 v2

难度 5/5 一周以上新手友好度 25/100

modelcontextprotocol/python-sdk#1743 · 9 条评论 · 2 个 reaction · 2025年12月5日创建
Introduce typed error classes with metadata 未关闭

breaking change enhancement P2 v2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#1742 · 1 条评论 · 3 个 reaction · 2025年12月5日创建
Support clean server shutdown 未关闭

enhancement P1 v2

modelcontextprotocol/python-sdk#1739 · 1 条评论 · 2 个 reaction · 已指派 1 人 · 2025年12月5日创建
Audit and document the MCP server publishing experience 未关闭

enhancement P2 v2

难度 4/5 3-5 天新手友好度 45/100

modelcontextprotocol/python-sdk#1734 · 1 条评论 · 2025年12月5日创建
`auth` specification in `ClientSessionGroup` 未关闭

auth enhancement help wanted needs decision P2

难度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#1723 · 4 条评论 · 1 个 reaction · 2025年12月4日创建
Document and provide hooks for sandboxing file and network access in MCP tools 未关闭

documentation enhancement needs confirmation

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#1705 · 28 条评论 · 2025年11月28日创建
Define and document the public Python SDK API surface 未关闭

breaking change enhancement P1 ready for work v2

modelcontextprotocol/python-sdk#1701 · 4 条评论 · 2 个 reaction · 已指派 1 人 · 2025年11月28日创建
Refactor func_metadata() into smaller components for schema & metadata generation 未关闭

enhancement needs decision P3

难度 5/5 一周以上新手友好度 42/100

modelcontextprotocol/python-sdk#1700 · 1 条评论 · 2025年11月28日创建
Simplify and harden session lifecycle with an explicit state machine 未关闭

enhancement P2 v2

难度 5/5 一周以上新手友好度 25/100

modelcontextprotocol/python-sdk#1691 · 2 条评论 · 2025年11月28日创建
MCP client doesn't not initialize new session when getting 404 session not found 未关闭

bug improves spec compliance P2 ready for work

难度 3/5 1-2 天新手友好度 70/100

modelcontextprotocol/python-sdk#1676 · 4 条评论 · 2025年11月26日创建
Streamable HTTP transport drops requests immediately after `initialize` 未关闭

bug P1 ready for work

难度 2/5 1-3 小时新手友好度 25/100

modelcontextprotocol/python-sdk#1675 · 1 条评论 · 2 个 reaction · 2025年11月26日创建
ServerSession methods (create_message, elicit_form) don't expose progress_callback parameter 未关闭

enhancement needs decision P2

难度 2/5 1-3 小时新手友好度 72/100

modelcontextprotocol/python-sdk#1671 · 2 条评论 · 2025年11月25日创建
User-Agent header in sHTTP transport is not forwarded to auth flow 未关闭

auth bug P2 ready for work

难度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/python-sdk#1664 · 5 条评论 · 1 个 reaction · 2025年11月25日创建
FastMCP configures logging on init, which messes up application-level logging 未关闭

bug P2 ready for work

难度 4/5 3-5 天新手友好度 45/100

modelcontextprotocol/python-sdk#1656 · 7 条评论 · 6 个 reaction · 2025年11月24日创建
ClientDisconnect returns HTTP 500 未关闭

bug P2 ready for work

难度 2/5 1-3 小时新手友好度 76/100

modelcontextprotocol/python-sdk#1648 · 6 条评论 · 1 个 reaction · 2025年11月20日创建
OAuth: 403 responses without insufficient_scope incorrectly retry with same token 未关闭

auth P3

难度 2/5 1-3 小时新手友好度 55/100

modelcontextprotocol/python-sdk#1602 · 2025年11月10日创建
Client tool call hangs forever if server crashes or connection dies when using streamable-http 未关闭

bug P2 ready for work

难度 3/5 1-2 天新手友好度 55/100

modelcontextprotocol/python-sdk#1577 · 3 条评论 · 2 个 reaction · 2025年11月5日创建
OAuthClientProvider._handle_token_response expect json 未关闭

bug P2 ready for work

难度 2/5 1-3 小时新手友好度 58/100

modelcontextprotocol/python-sdk#1523 · 1 个 reaction · 2025年10月28日创建
FastMCP: Support dynamic annotation updates 未关闭

enhancement improves spec compliance P2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/python-sdk#1475 · 2 条评论 · 1 个 reaction · 2025年10月13日创建
Improve docs on how to use `instructions` on `InitializeResult` 未关闭

documentation P1 ready for work

难度 2/5 1-3 小时新手友好度 68/100

modelcontextprotocol/python-sdk#1464 · 4 条评论 · 1 个 reaction · 2025年10月10日创建
Response leak in SSE handlers 未关闭

needs repro P2 ready for work

难度 2/5 1-3 小时新手友好度 58/100

modelcontextprotocol/python-sdk#1450 · 3 条评论 · 2025年10月9日创建
feat: enhance dynamic tool management with notifications and enable/disable 未关闭

enhancement needs decision P1 v2

难度 4/5 3-5 天新手友好度 38/100

modelcontextprotocol/python-sdk#1429 · 4 条评论 · 2 个 reaction · 2025年10月6日创建
It is not possible to define a Resource that takes only the Context parameter as an argument. 未关闭

bug improves spec compliance P2 ready for work

难度 3/5 1-2 天新手友好度 42/100

modelcontextprotocol/python-sdk#1405 · 2 条评论 · 2025年9月26日创建
ClientSession Error Handling 未关闭

bug good first issue P1 ready for work

难度 4/5 3-5 天新手友好度 45/100

modelcontextprotocol/python-sdk#1401 · 22 条评论 · 7 个 reaction · 2025年9月25日创建
Lazy HTTP connections seem to make error handling difficult. 未关闭

enhancement needs decision P2

难度 4/5 3-5 天新手友好度 30/100

modelcontextprotocol/python-sdk#1393 · 2025年9月24日创建
No default timeout for requests (unlike TS SDK) 未关闭

enhancement improves sdk consistency needs decision P2

难度 4/5 3-5 天新手友好度 35/100

modelcontextprotocol/python-sdk#1374 · 4 条评论 · 2025年9月17日创建
Using /.well-known/ OAuth endpoints behind custom path on GKE 未关闭

auth enhancement good first issue needs decision P2 question

难度 4/5 3-5 天新手友好度 45/100

modelcontextprotocol/python-sdk#1335 · 4 条评论 · 2025年9月2日创建
`stdio_server` uses unbuffered memory streams which can cause server to block and become unresponsive 未关闭

bug P2 ready for work

难度 2/5 1-3 小时新手友好度 52/100

modelcontextprotocol/python-sdk#1333 · 1 条评论 · 1 个 reaction · 2025年9月1日创建
Implement consistent structuredContent handling per specification clarification 未关闭

bug enhancement needs decision P3 pending SEP approval

难度 5/5 一周以上新手友好度 25/100

modelcontextprotocol/python-sdk#1332 · 1 条评论 · 2025年9月1日创建
Clients Using Storage Face Deadlock on Token Refresh for SSE 未关闭

bug P2 ready for work

难度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/python-sdk#1326 · 4 条评论 · 2025年8月30日创建
Support selection of authorization servers from PRM document 未关闭

auth enhancement

难度 4/5 3-5 天新手友好度 35/100

modelcontextprotocol/python-sdk#1319 · 2025年8月28日创建
Critical Token Refresh Bugs - Prevents Proactive Refresh 未关闭

auth P1 ready for work

难度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/python-sdk#1318 · 9 条评论 · 6 个 reaction · 2025年8月28日创建

modelcontextprotocol/python-sdk

把新 issue 发到你的邮箱