MCP Python SDK

MCP Python SDK：Anthropic 主导的 Model Context Protocol 参考实现。2 server 层 + 3 transport + 3 原语 + 4 协议版本 + 50 条约束。

APIAI机器学习
✓ 0 人报告成功·v0.1.0·

晶体简介

MCP Python SDK 是 Model Context Protocol 的参考实现（github.com/modelcontextprotocol/python-sdk）—— Anthropic 主导的开放标准，让 AI host（Claude / Cursor 等）通过 JSON-RPC 2.0 跟工具服务端对话。 两个 server 接口：低层 Server（构造器注入 handler）和高层 MCPServer（装饰器 API，原名 FastMCP）。三个传输共享结构化 (read_stream, write_stream) AnyIO 契约：stdio（行分隔 JSON）、传统 SSE、推荐的 streamable-http（单端点 + 可选 EventStore ABC 提供 resumability）。三个原语：Tools（副作用操作）/ Resources（只读上下文）/ Prompts（模板）。 本 skill 自带 50 条约束（含 1 条 fatal），覆盖典型踩坑：commit 3d7b311 的 README 仍 import 改名前的 FastMCP（26 处 import 行 + 10 处文件路径失效）；DNS-rebinding 保护只对 127.0.0.1/localhost/::1 自动开启，生产host 默认无保护；stateless HTTP 模式下 sampling/elicitation/list_roots 在调用时抛 StatelessModeNotSupported。

Blueprint Source

finance-bp-140

modelcontextprotocol/python-sdk3d7b3111 source file

Constraints

1total
1fatal
1 must-not-violate

Evidence Quality

Confidence90%

High confidence — strong evidence base

1 条不可违反的约束

FATALoperational_lessonmcp-C-001

WHENWhen following README quickstart code at commit 3d7b311 to build an MCP server

ACTIONtranslate every `from mcp.server.fastmcp import FastMCP` line (≥26 occurrences in README at lines 147, 231, 293, 324, 349, 419, 470, 572, 573, 600, 640, 665, 697, 830, 937, 974, 1017, 1211, 1255, 1297, 1410, 1457, 1504, 1565, 1602, 1623) to `from mcp.server.mcpserver import MCPServer` and instantiate `MCPServer(...)` instead of `FastMCP(...)`; `mcp.server.fastmcp` package no longer exists

CONSEQUENCECopy-pasting README import statements raises ModuleNotFoundError: No module named 'mcp.server.fastmcp' immediately at import time, blocking any further work on the server before a single line of business logic runs

domain-constraint

常见问题

讨论 (0)

暂无讨论，成为第一个发言的人吧！

更新历史

v0.1.02026-04-25·贡献者： tangweigang-jpg

v0.1.0: 首次发布到 Doramagic.ai。基于 modelcontextprotocol/python-sdk 的 MCP 参考实现，中英双语 + 50 条 anti-pattern 约束 + 3 条 FAQ。

v0.1.02026-04-25·贡献者： tangweigang-jpg

v0.1.0: 首次发布到 Doramagic.ai。基于 modelcontextprotocol/python-sdk 的 MCP 参考实现，中英双语 + 50 条 anti-pattern 约束 + 3 条 FAQ。