modelcontextprotocol

modelcontextprotocol/python-sdk

The official Python SDK for Model Context Protocol servers and clients

23.7K stars 3.7K forks 23.7K watchers Python MIT License
View on GitHub Website
35 Open Issues Need Help Last updated: Jul 24, 2026

Open Issues Need Help

View All on GitHub
Using transport="stdio" closes real stdio, causing ValueError after server exits 7 days ago
bug good first issue P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
No way to set isError=True for arbitrary tool result content about 1 month ago
good first issue enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Controlling Context in Client for Sampling Requests about 2 months ago
documentation good first issue ready for work P1
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
ClientSession Error Handling about 2 months ago
bug good first issue ready for work P1
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Improving how function docstring gets converted to tool's jsonschema for FastMCP about 2 months ago
good first issue enhancement P2 needs decision
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Add `invalid_target` to `AuthorizationErrorCode` (RFC 8707) 2 months ago
bug good first issue auth P2 fix proposed
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Using /.well-known/ OAuth endpoints behind custom path on GKE 4 months ago
good first issue question auth enhancement P2 needs decision
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
`auth` specification in `ClientSessionGroup` 4 months ago
auth enhancement P2 help wanted needs decision
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Context logging function types are not spec compliant 4 months ago
bug good first issue ready for work
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
stdio_client fails with BrokenResourceError during initialization 4 months ago
bug good first issue P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
MCP server: AccessToken class should have field for subject claim ("sub") 5 months ago
good first issue enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
No logging in `_handle_stateful_request` when session ID is unknown/expired 5 months ago
good first issue enhancement P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Update _client_info on the ClientSession upon initialization with serverInfo 5 months ago
good first issue enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
support logging to stderr in Jupyter Notebook Environments. 5 months ago
bug good first issue ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Missing `call` capability in tasks.requests.tools causes VS Code Copilot to ignore task support 7 months ago
bug good first issue P2
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
DCR Handler Requires Both authorization_code and refresh_token Grant Types (RFC 7591 Non-Compliant) 7 months ago
bug good first issue auth P2
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
UrlElicitationRequiredError not thrown as an McpError exception 8 months ago
bug ready for work P2 help wanted
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Test fails in a Windows system with a proxy enabled 8 months ago
bug good first issue ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Add default /docs route to list information about the SSE MCP server 8 months ago
good first issue enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Drop uvicorn from test suite 9 months ago
good first issue enhancement ready for work P2
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Custom objects result in large input schema blocks 9 months ago
good first issue enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Support generate input schema from "Args" part of func doc with decorater @mcp.tool() 9 months ago
good first issue enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Specifying capabilities w/ FastMCP Server 9 months ago
good first issue v2 enhancement ready for work P2
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Implement OAuth relying on Authlib 9 months ago
good first issue auth enhancement ready for work P1
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
client_credentials grant type for mcp oauth 9 months ago
good first issue auth enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Context.log does not actually accept or pass forward extra kwargs 9 months ago
bug good first issue ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Support low-level interface for modifying the underlying Uvicorn server 9 months ago
good first issue v2 enhancement ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Documentation on mounting to existing ASGI server is missing information 10 months ago
documentation good first issue ready for work P0
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Remote file support for `mcp run` 10 months ago
good first issue needs more eyes feature request ready for work P3
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
MCP Python SDK Implementation Gap-10: MCP Python SDK Client Missing Token Issuer Validation 10 months ago
bug good first issue PR welcome auth ready for work P0
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Support for `path` convertor `{value:path}` in FastMCP 10 months ago
good first issue needs maintainer action feature request ready for work P1
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Server url truncated by urllib in FastMCP 10 months ago
bug good first issue
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
FastMCP should support all of RFC 6570 10 months ago
help wanted PR welcome ready for work
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
SDK doesn't support specifying tool metadata? 11 months ago
enhancement good first issue help wanted
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python
Inconsistent Field Naming Between `outputSchema` and `model_dump` about 1 year ago

AI Summary: The task requires modifying the MCP Python SDK to ensure consistency between the `outputSchema` displayed to clients and the actual data returned by tools using Pydantic models. This involves adding the `by_alias=True` argument to the `model_dump` function call within the SDK's `func_metadata.py` file to utilize the aliases defined in the Pydantic models.

Complexity: 3/5
bug good first issue
modelcontextprotocol/python-sdk
23.7K

The official Python SDK for Model Context Protocol servers and clients

Python