Support clean server shutdown

Open

#1,739 opened on Dec 5, 2025 1 comment 2 reactions 1 assignee View on GitHub

@felixweinberger is already working on this.

Since Jan 15, 2026.

Assessment

This issue has not been assessed yet.

Description

enhancement P1 v2

Summary

Provide a reliable way to cleanly shut down a running MCP server, ensuring all resources are properly released.

Motivation

Currently there's no clean way to stop a running server programmatically
Resources (connections, tasks, file handles) may not be properly cleaned up on shutdown
Important for testing, graceful restarts, and production deployments

Goal

API for triggering graceful shutdown
Proper cleanup of all active sessions and transports
Configurable shutdown timeout / drain period

_{AI Disclaimer}

Dominant language: Python
Stars: 24.3k
Forks: 4k
Avg merge: 1d 16h
Merged PRs (30d): 25

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

More from modelcontextprotocol/python-sdk

ClientSessionGroup raises KeyError when connecting a server that exposes no components Open

v1 v2

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

modelcontextprotocol/python-sdk#3578 · 1 comment · Opened Sep 24, 2026
func_metadata raises uncaught PydanticSchemaGenerationError for Iterator/AsyncIterator tool return annotations instead of the unstructured fallback Open

v1 v2

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

modelcontextprotocol/python-sdk#3573 · 2 comments · Opened Sep 23, 2026
OAuth client scope handling breaks on comma-separated scope strings Open

v2

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

modelcontextprotocol/python-sdk#3566 · Opened Sep 23, 2026
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) Open

v1 v2

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

modelcontextprotocol/python-sdk#3546 · 5 comments · Opened Sep 19, 2026
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) Open

v1 v2

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

modelcontextprotocol/python-sdk#3545 · 2 comments · Opened Sep 18, 2026

All issues in modelcontextprotocol/python-sdk

Similar issues

validate-structure inspecte challenge/work/.terraform et rend faux les labs qui ont un provider en cache Open

bug

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

stephrobert/dsoxlab#238 · Opened Sep 24, 2026
Uniform probability densities use the upper bound as an interval width Open

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

nasa/fmdtools#40 · Opened Sep 24, 2026
_common_folder() treats a single file as the common folder; single-file archives can't be installed (4.2.8) / crash (master) Open

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

sublimehq/package_control#1780 · Opened Sep 24, 2026
Set 'Sample' input in 'autorun.py' to utilize 'Sample' Tab in eLog Open

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

pcdshub/mfx#309 · 2 comments · Opened Sep 24, 2026
niri config file addition does not respect existing optional include Open

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

nwg-piotr/nwg-displays#145 · Opened Sep 24, 2026

More Python issues

A short digest of beginner-friendly GitHub issues.