modelcontextprotocol/python-sdk

View on GitHub

The official Python SDK for Model Context Protocol servers and clients

Stars: 24.3k
Forks: 4k
Open beginner issues: 17
Indexed issues: 241
Avg merge: 1d 1h
Merged PRs (30d): 31

Dominant language: Python
License: MIT
Last GitHub push: Sep 16, 2026
Latest indexed: Sep 20, 2026
Contributing guide: Contributing guide
Code of conduct: Code of conduct
Beginner labels: good first issue help wanted

Beginner friendly Everything

Open All

241 open issues indexed

OAuth TokenHandler should check Authorization header for client credentials Open

auth enhancement

modelcontextprotocol/python-sdk#1315 · 6 comments · 2 reactions · 1 assignee · Opened Aug 27, 2025
Error & Mismatch in OAuth scope resolution between Claude.ai/MCP Python SDK and Inspector Open

auth bug ready for work

Difficulty 3/5 1-2 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#1307 · 1 comment · Opened Aug 26, 2025
401 in Streamable HTTP should be handled gracefully Open

bug P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 74/100

modelcontextprotocol/python-sdk#1295 · 2 comments · 1 reaction · Opened Aug 22, 2025
Modular system to define MCP Primitives Open

enhancement needs decision P2

Difficulty 5/5 Over a week Newbie friendliness 32/100

modelcontextprotocol/python-sdk#1281 · 5 comments · Opened Aug 18, 2025
Streamable HTTP client performance regression starting with v1.12.0 Open

bug P2 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 38/100

modelcontextprotocol/python-sdk#1274 · 2 comments · Opened Aug 14, 2025
Server hangs when shutting down if a connection is still open Open

bug P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#1272 · 2 comments · 6 reactions · Opened Aug 14, 2025
FastMCP server death on client HEAD calls Open

bug P2 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1269 · 6 comments · Opened Aug 13, 2025
Trailing slash in `.well-known/oauth-protected-resource` response may violate “Canonical Server URI” requirement Open

auth bug P1 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#1265 · 2 comments · Opened Aug 12, 2025
Protected Resource Metadata resource erroneous when setting up authentication on server Open

auth bug P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 58/100

modelcontextprotocol/python-sdk#1264 · 7 comments · 2 reactions · Opened Aug 12, 2025
Don’t use shell=True in mcp dev subprocess on Windows (command injection risk) Open

bug fix proposed P1 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 72/100

modelcontextprotocol/python-sdk#1257 · 3 comments · Opened Aug 10, 2025
Python SDK v2 Open

enhancement P1 ready for work v2

modelcontextprotocol/python-sdk#1253 · 2 comments · 3 assignees · Opened Aug 9, 2025
Framework does not handle refreshed tokens correctly Open

auth bug P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 38/100

modelcontextprotocol/python-sdk#1250 · 12 comments · 1 reaction · Opened Aug 8, 2025
Implement OAuth relying on Authlib Open

auth enhancement P1 ready for work

modelcontextprotocol/python-sdk#1240 · 7 comments · 1 reaction · 1 assignee · Opened Aug 5, 2025
Middleware Support in MCP Open

enhancement needs decision P1 v2

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1233 · 3 comments · 2 reactions · Opened Aug 4, 2025
Progress notifications cause server to hang on stdio transport Open

bug P3 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#1141 · 4 comments · Opened Jul 14, 2025
Specifying capabilities w/ FastMCP Server Open

enhancement needs decision P2 v2

Difficulty 3/5 1-2 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1126 · 2 comments · Opened Jul 11, 2025
MCP client not able to initiate StdioServerParameters while running in Jupyter Notebook Open

bug needs repro

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1103 · 6 comments · 2 reactions · Opened Jul 8, 2025
PydanticSchemaGenerationError: Unable to generate pydantic-core schema for Image type Open

bug P2 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 62/100

modelcontextprotocol/python-sdk#1060 · 4 comments · 1 reaction · Opened Jun 30, 2025
Enable FastMCP to filter tools, prompts, resources using a fine grained policy Open

auth enhancement v2

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#1031 · 3 comments · 2 reactions · Opened Jun 25, 2025
Exception in `ClientSessionGroup` if `streamable_http` MCP server is not available Open

bug fix proposed P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#915 · 12 comments · 7 reactions · Opened Jun 10, 2025
AssertionError: Unexpected message while using middlewares Open

bug P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 42/100

modelcontextprotocol/python-sdk#883 · 15 comments · 6 reactions · Opened Jun 4, 2025
Client Credentials In the token Handler Open

auth enhancement improves spec compliance P1 pending SEP approval

Difficulty 3/5 1-2 days Newbie friendliness 52/100

modelcontextprotocol/python-sdk#881 · 1 comment · 4 reactions · Opened Jun 3, 2025
STDIO hangs forever when the using multiprocessing in tools Open

enhancement needs decision P3

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#817 · 3 comments · Opened May 27, 2025
Support for API Gateway Path Prefixes in SSE Client URL Handling Open

bug P1 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 52/100

modelcontextprotocol/python-sdk#795 · 2 comments · 3 reactions · Opened May 23, 2025
Allow installing mcp servers from pypi Open

enhancement needs decision P3

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#762 · 3 comments · Opened May 20, 2025
[Feature] De-couple Starlette from FastMCP to make it easier to implement MCP endpoints in other frameworks Open

enhancement needs decision P3 v2

Difficulty 5/5 Over a week Newbie friendliness 30/100

modelcontextprotocol/python-sdk#622 · 1 comment · 15 reactions · Opened May 3, 2025
`RuntimeError: Attempted to exit cancel scope in a different task` when cleaning up multiple MCPClient instances out-of-order Open

bug P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#577 · 11 comments · 6 reactions · Opened Apr 24, 2025
FastMCP server with SSE transport fails to shut down on a signal Open

bug P3 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 48/100

modelcontextprotocol/python-sdk#514 · 12 comments · 6 reactions · Opened Apr 14, 2025
MCP SSE Server: Received request before initialization was complete Open

bug P2 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#423 · 25 comments · 29 reactions · Opened Apr 3, 2025
Option to not rewrite the logging configuration Open

enhancement needs decision P1

Difficulty 3/5 1-2 days Newbie friendliness 68/100

modelcontextprotocol/python-sdk#420 · 11 comments · 23 reactions · Opened Apr 3, 2025
No way to set isError=True for arbitrary tool result content Open

enhancement good first issue P3 ready for work

modelcontextprotocol/python-sdk#348 · 6 comments · 1 assignee · Opened Mar 23, 2025
[docs] How to run FastMCP with args or env vars? Open

documentation P2 ready for work

Difficulty 2/5 1-3 hours Newbie friendliness 68/100

modelcontextprotocol/python-sdk#339 · 3 comments · 1 reaction · Opened Mar 21, 2025
Synchronous Python Client Open

enhancement needs confirmation P2

Difficulty 4/5 3-5 days Newbie friendliness 45/100

modelcontextprotocol/python-sdk#309 · 8 comments · 16 reactions · Opened Mar 18, 2025
Low-level Server support for mcp dev and mcp run command Open

enhancement needs decision P1

Difficulty 5/5 Over a week Newbie friendliness 30/100

modelcontextprotocol/python-sdk#299 · 2 comments · 5 reactions · Opened Mar 16, 2025
cannot get response from await session.call_tool() Open

bug P1 ready for work

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#262 · 16 comments · 6 reactions · Opened Mar 12, 2025
Official Adapter Functions for LLM Providers in MCP Python SDK Open

enhancement needs decision P3

Difficulty 5/5 Over a week Newbie friendliness 35/100

modelcontextprotocol/python-sdk#235 · 8 comments · 18 reactions · Opened Feb 27, 2025
Improving how function docstring gets converted to tool's jsonschema for FastMCP Open

enhancement good first issue needs decision P2

Difficulty 4/5 3-5 days Newbie friendliness 52/100

modelcontextprotocol/python-sdk#226 · 13 comments · 16 reactions · Opened Feb 21, 2025
Add default /docs route to list information about the HTTP MCP server Open

enhancement needs decision P3

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#193 · 5 comments · 1 reaction · Opened Feb 7, 2025
support logging to stderr in Jupyter Notebook Environments. Open

bug good first issue P3 ready for work

Difficulty 3/5 1-2 days Newbie friendliness 58/100

modelcontextprotocol/python-sdk#156 · 12 comments · Opened Jan 17, 2025
Add conveniences for MCP proxy pattern Open

enhancement needs decision P1 v2

Difficulty 4/5 3-5 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#12 · Opened Oct 11, 2024
Specific transports could be Python package extras Open

breaking change enhancement needs decision P3 v2

Difficulty 3/5 1-2 days Newbie friendliness 35/100

modelcontextprotocol/python-sdk#3 · 1 comment · 3 reactions · Opened Sep 25, 2024

modelcontextprotocol/python-sdk

Get new issues in your inbox