Skip to content

Commit 701a86e

Browse files
dsp-antdsp-ant
committed
v1.3.0rc1
1 parent faf3a9d commit 701a86e

File tree

2 files changed

+149
-1
lines changed

2 files changed

+149
-1
lines changed

‎CHANGELOG.md

+148
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,148 @@
1+
# Changelog
2+
3+
## [1.3.0rc1] - 2025-02-13
4+
5+
### Breaking Changes
6+
7+
- **Context API Changes**: The Context logging methods (info, debug, warning, error) are now async and must be awaited. ([#172](https://github.com/modelcontextprotocol/python-sdk/pull/172))
8+
- **Resource Response Format**: Standardized resource response format to return both content and MIME type. Method `read_resource()` now returns a tuple of `(content, mime_type)` instead of just content. ([#170](https://github.com/modelcontextprotocol/python-sdk/pull/170))
9+
10+
### New Features
11+
12+
#### Lifespan Support
13+
Added comprehensive server lifecycle management through the lifespan API:
14+
```python
15+
@dataclass
16+
class AppContext:
17+
db: Database
18+
19+
@asynccontextmanager
20+
async def app_lifespan(server: FastMCP) -> AsyncIterator[AppContext]:
21+
try:
22+
await db.connect()
23+
yield AppContext(db=db)
24+
finally:
25+
await db.disconnect()
26+
27+
mcp = FastMCP("My App", lifespan=app_lifespan)
28+
29+
@mcp.tool()
30+
def query_db(ctx: Context) -> str:
31+
db = ctx.request_context.lifespan_context["db"]
32+
return db.query()
33+
```
34+
([#203](https://github.com/modelcontextprotocol/python-sdk/pull/203))
35+
36+
#### Async Resources
37+
Added support for async resource functions in FastMCP:
38+
```python
39+
@mcp.resource("users://{user_id}")
40+
async def get_user(user_id: str) -> str:
41+
async with client.session() as session:
42+
response = await session.get(f"/users/{user_id}")
43+
return await response.text()
44+
```
45+
([#157](https://github.com/modelcontextprotocol/python-sdk/pull/157))
46+
47+
#### Concurrent Request Handling
48+
Made message handling concurrent, allowing multiple requests to be processed simultaneously. ([#206](https://github.com/modelcontextprotocol/python-sdk/pull/206))
49+
50+
#### Request Cancellation
51+
Added support for canceling in-flight requests and cleaning up resources. ([#167](https://github.com/modelcontextprotocol/python-sdk/pull/167))
52+
53+
#### Server Instructions
54+
Added support for the `instructions` field in server initialization, allowing servers to provide usage guidance. ([#150](https://github.com/modelcontextprotocol/python-sdk/pull/150))
55+
56+
### Bug Fixes
57+
58+
- Fixed progress reporting for first tool call by correcting progress_token handling ([#176](https://github.com/modelcontextprotocol/python-sdk/pull/176))
59+
- Fixed server crash when using debug logging ([#158](https://github.com/modelcontextprotocol/python-sdk/pull/158))
60+
- Fixed resource template handling in FastMCP server ([#137](https://github.com/modelcontextprotocol/python-sdk/pull/137))
61+
- Fixed MIME type preservation in resource responses ([#170](https://github.com/modelcontextprotocol/python-sdk/pull/170))
62+
- Fixed documentation for environment variables in CLI commands ([#149](https://github.com/modelcontextprotocol/python-sdk/pull/149))
63+
- Fixed request ID preservation in JSON-RPC responses ([#205](https://github.com/modelcontextprotocol/python-sdk/pull/205))
64+
65+
### Dependency Updates
66+
67+
- Relaxed version constraints for better compatibility:
68+
- `pydantic`: Changed from `>=2.10.1,<3.0.0` to `>=2.7.2,<3.0.0`
69+
- `pydantic-settings`: Changed from `>=2.6.1` to `>=2.5.2`
70+
- `uvicorn`: Changed from `>=0.30` to `>=0.23.1`
71+
([#180](https://github.com/modelcontextprotocol/python-sdk/pull/180))
72+
73+
### Examples
74+
75+
- Added a simple chatbot example client to demonstrate SDK usage ([#98](https://github.com/modelcontextprotocol/python-sdk/pull/98))
76+
77+
### Internal Improvements
78+
79+
- Improved type annotations for better IDE support ([#181](https://github.com/modelcontextprotocol/python-sdk/pull/181))
80+
- Added comprehensive tests for SSE transport ([#151](https://github.com/modelcontextprotocol/python-sdk/pull/151))
81+
- Updated types to match 2024-11-05 MCP schema ([#165](https://github.com/modelcontextprotocol/python-sdk/pull/165))
82+
- Refactored request and notification handling for better code organization ([#166](https://github.com/modelcontextprotocol/python-sdk/pull/166))
83+
84+
## [1.2.1] - 2024-01-27
85+
86+
### Added
87+
- Support for async resources
88+
- Example and test for parameter descriptions in FastMCP tools
89+
90+
### Fixed
91+
- MCP install command with environment variables
92+
- Resource template handling in FastMCP server (#129)
93+
- Package in the generated MCP run config (#128)
94+
- FastMCP logger debug output
95+
- Handling of strings containing numbers in FastMCP (@sd2k, #142)
96+
97+
### Changed
98+
- Refactored to use built-in typing.Annotated instead of typing_extensions
99+
- Updated uv.lock
100+
- Added .DS_Store to gitignore
101+
102+
# MCP Python SDK v1.2.0rc1 Release Notes
103+
104+
## Major Features
105+
106+
### FastMCP Integration
107+
- Integrated [FastMCP](https://github.com/jlowin/fastmcp) as the recommended high-level server framework
108+
- Added new `mcp.server.fastmcp` module with simplified decorator-based API
109+
- Introduced `FastMCP` class for easier server creation and management
110+
- Added comprehensive documentation and examples for FastMCP usage
111+
112+
### New CLI Package
113+
- Added new CLI package for improved developer experience
114+
- Introduced `mcp dev` command for local development and testing
115+
- Added `mcp install` command for Claude Desktop integration
116+
- Added `mcp run` command for direct server execution
117+
118+
## Improvements
119+
120+
### Documentation
121+
- Completely revamped README with new structure and examples
122+
- Added detailed sections on core concepts (Resources, Tools, Prompts)
123+
- Updated documentation to recommend FastMCP as primary API
124+
- Added sections on development workflow and deployment options
125+
- Improved example server documentation
126+
127+
### Developer Experience
128+
- Added pre-commit hooks for code quality
129+
- Updated to Pydantic 2.10.0 for improved type checking
130+
- Added uvicorn as a dependency for better server capabilities
131+
132+
## Bug Fixes
133+
- Fixed deprecation warnings in core components
134+
- Fixed Pydantic field handling for meta fields
135+
- Fixed type issues throughout the codebase
136+
- Fixed example server READMEs
137+
138+
## Breaking Changes
139+
- Deprecated direct usage of `mcp.server` in favor of `mcp.server.fastmcp`
140+
- Updated import paths for FastMCP integration
141+
- Changed recommended installation to include CLI features (`pip install "mcp[cli]"`)
142+
143+
## Contributors
144+
Special thanks to all contributors who made this release possible, including:
145+
- Jeremiah Lowin (FastMCP)
146+
- Oskar Raszkiewicz
147+
148+
**Full Changelog**: https://github.com/modelcontextprotocol/python-sdk/compare/v1.1.2...v1.2.0rc1

‎pyproject.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "mcp"
3-
version = "1.3.0.dev0"
3+
version = "1.3.0rc1"
44
description = "Model Context Protocol SDK"
55
readme = "README.md"
66
requires-python = ">=3.10"

0 commit comments

Comments
 (0)