Active Streamable HTTP sessions are not terminated during shutdown

未關閉

#2,150 建立於 2026年2月26日 3 則留言 0 個 reaction 已指派 0 人在 GitHub 檢視

還沒有人認領這個 Issue。

評估

難度: 4/5
預估耗時: 3-5 天
新手友好度: 48/100

Issue 類型: 缺陷
描述清晰度: 基本清楚
活躍度: 冷清
技術堆疊: python
領域: api, backend

研究方向

從 StreamableHTTPSessionManager 的 shutdown 處理開始，並使用 Python 3.12 下的 streamable-http 範例重現問題。追蹤作用中的 SSE 或串流連線如何被取消，然後確認 shutdown 會以適當的 HTTP 回應關閉這些連線，且不會出現 Uvicorn ASGI 錯誤。

由索引模型根據 Issue 內容生成。

描述

bug P2 ready for work

Initial Checks

I confirm that I'm using the latest version of MCP Python SDK
I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue

Description

Context

This is primarily a repost of this fastmcp issue as it seems to actually be a bug in the mcp python sdk and I want to make sure we've got visibility over here.

When shutting down a FastMCP server (CTRL+C) while clients have active streaming connections, Uvicorn logs:
ERROR: ASGI callable returned without completing response.
The error occurs because StreamableHTTPSessionManager cancels the task group without first gracefully terminating active SSE/streaming connections.

Expected behavior would be the active connections being closed with a proper http response before the rest of shutdown.

Example Code

from fastmcp import FastMCP

mcp = FastMCP("Test Server")

@mcp.tool
def hello() -> str:
  return "Hello, World!"

if __name__ == "__main__":
  mcp.run(transport="streamable-http", port=8000)

Python & MCP Python SDK

Python 3.12
MCP Python SDK 1.26.0

主要語言: Python
星號: 24.3k
分支: 4k
平均合併: 1 天 11 小時
30 天內合併 PR: 30

貢獻指南

開啟貢獻指南

從這裡開始

先讀完整個 Issue，再讀專案的貢獻指南。
在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
Fork 儲存庫，在一個分支上完成修改。
送出 Pull Request，並在描述裡引用這個 Issue 編號。

modelcontextprotocol/python-sdk 的其他 Issue

OAuth client scope handling breaks on comma-separated scope strings 未關閉

難度 2/5 1-3 小時新手友好度 75/100

modelcontextprotocol/python-sdk#3566 · 2026年9月23日建立
Streamable HTTP client logs a WARNING for valid 202 Accepted on session termination (DELETE) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 85/100

modelcontextprotocol/python-sdk#3546 · 5 則留言 · 2026年9月19日建立
Server ClientAuthenticator requires client_id in token body, rejecting valid client_secret_basic requests (RFC 6749 §2.3.1) 未關閉

v1 v2

難度 2/5 1-3 小時新手友好度 76/100

modelcontextprotocol/python-sdk#3545 · 1 則留言 · 2026年9月18日建立
Revocation requires client_secret to be present 未關閉

v1 v2

難度 1/5 1 小時以內新手友好度 91/100

modelcontextprotocol/python-sdk#3508 · 2 則留言 · 2026年9月15日建立
Does same-origin redirect enforcement break MCP servers behind a reverse proxy? 未關閉

難度 2/5 1-3 小時新手友好度 64/100

modelcontextprotocol/python-sdk#3504 · 2026年9月15日建立

查看 modelcontextprotocol/python-sdk 的全部 Issue

相似的 Issue

PATCH /interviews/{id} 的 goal 字段没有任何长度上限，500KB 字符串直接落库且每次 GET detail 都全量带回未關閉

bug

難度 2/5 1-3 小時新手友好度 75/100

xinnan-tech/xiaozhi-fde-talk#263 · 2026年9月24日建立
rules: REQ-0480 'left fold' jargon is redundant with its own plain restatement 未關閉

rules

難度 1/5 1 小時以內新手友好度 90/100

elong0527/yamaa#978 · 2026年9月24日建立
Validation discards output from runners that report on stderr (jest, unittest) 未關閉

難度 2/5 1-3 小時新手友好度 70/100

huggingface/Repo2RLEnv#163 · 1 則留言 · 2026年9月24日建立
Source link in quantize_embeddings have shifted code highlights 未關閉

難度 1/5 1 小時以內新手友好度 95/100

huggingface/sentence-transformers#4074 · 2026年9月24日建立
Queue insertion button ("插入排队消息") missing in api_server sessions — canInsert allowlist only covers cli/global_agent 未關閉

comp/dashboard invalid P3

難度 2/5 1-3 小時新手友好度 70/100

NousResearch/hermes-agent#121143 · 2026年9月24日建立

更多 Python Issue

精選適合新手參與的 GitHub issue 摘要。