modelcontextprotocol

modelcontextprotocol/python-sdk

The official Python SDK for Model Context Protocol servers and clients

35 good first / help-wanted issues · Python · last activity Jul 24, 2026

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

No way to set isError=True for arbitrary tool result content 13 days 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

ClientSession Error Handling 18 days 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

support logging to stderr in Jupyter Notebook Environments. 19 days 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

Using transport="stdio" closes real stdio, causing ValueError after server exits 26 days ago

bug good first issue P3

modelcontextprotocol/python-sdk

23.7K

The official Python SDK for Model Context Protocol servers and clients

Python

`auth` specification in `ClientSessionGroup` about 1 month 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

Controlling Context in Client for Sampling Requests 4 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

Improving how function docstring gets converted to tool's jsonschema for FastMCP 4 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) 5 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 6 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

Context logging function types are not spec compliant 7 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 7 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") 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

No logging in `_handle_stateful_request` when session ID is unknown/expired 8 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 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

Missing `call` capability in tasks.requests.tools causes VS Code Copilot to ignore task support 9 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) 10 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 11 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 11 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 11 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 12 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 12 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() 12 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 12 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 12 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 12 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 12 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 12 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 about 1 year 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` about 1 year 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 about 1 year 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 about 1 year 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 about 1 year 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 about 1 year 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? about 1 year 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` over 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