ceos/fastmcp
1
0
Fork 0
mirror of https://github.com/PrefectHQ/fastmcp.git synced 2026-08-21 04:54:17 +02:00
Code Issues Projects Releases Packages Wiki Activity
3,889 commits 156 branches 116 tags 71 MiB
Commit graph

171 commits

Author SHA1 Message Date
Jeremiah Lowin
04f9971120
 		Delegate typed tool output serialization to Pydantic (#4771) 2026-08-06 19:59:19 -04:00
Jeremiah Lowin
baced6281c
 		Always emit a tool title, derived from name when unset (#4694) 
* Always emit a tool title, derived from name when unset

Some MCP clients (e.g. ChatGPT) drop tools with no `title` instead of
falling back to `name` for display as the spec allows. Deriving a
default title in Tool.to_mcp_tool() fixes this for every tool built on
top of it, including the search-transform, code-mode, and session
proxy tools that never set one explicitly.

Fixes #4414

* Derive fallback title from the overridden name, document it

Addresses Codex review on #4694.

* Resolve title precedence from effective overrides

* Normalize mapping annotations before deriving the title
 2026-07-28 17:30:20 -04:00
Jeremiah Lowin
8b76710e66
 		Move to the stable MCP Python SDK 2.0.0 (#4655) 2026-07-28 16:31:49 -04:00
Jeremiah Lowin
a8b5da9770
 		Late-bind app tool names so UIs survive composition (#4682) 2026-07-28 10:54:19 -04:00
Jeremiah Lowin
ea7fb8cb2e
 		Remove 3.x-era compatibility shims (#4661) 
* Remove 3.x-era compatibility shims

* Require response_type in ctx.elicit()

* Name the utilities path for the two non-re-exported auth helpers

* Point sampling handler migration at its submodule
 2026-07-27 14:59:43 -04:00
Jeremiah Lowin
3f746b91fc
 		Merge remote-tracking branch 'origin/main' into claude/mcp-background-tasks-v2-0f883f 
# Conflicts:
#	fastmcp_slim/fastmcp/server/dependencies.py
 2026-07-23 19:32:52 -04:00
Liang Hu
99327084d2
 		Preserve raw CallToolResult returns (#4587) 
Co-authored-by: nate nowack <thrast36@gmail.com>
 2026-07-23 15:10:42 -05:00
Jeremiah Lowin
6fce4e538f
 		Move task subsystem to fastmcp-tasks package, disconnect SEP-1686 wire from core 
Engine modules (keys, context snapshot, docket lifespan, worker CLI,
client handles) move intact; SEP-1686 wire modules park in _legacy_wire
for adaptation to SEP-2663. Core keeps task=True declaration on tools
only and raises at serve time until the tasks extension is registered.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-07-21 21:51:45 -04:00
Jeremiah Lowin
b0e782a2ee
 		Make the unit suite fast: in-process HTTP tests, no real sleeps, parallel Windows CI (#4554) 2026-07-20 10:51:14 -04:00
Marcelo Trylesinski
7934124fb5
 		Make transformed tool required order deterministic (#4564) 
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
 2026-07-20 07:12:45 -05:00
Jeremiah Lowin
918b85f9b2
 		Reject positional-only tool parameters (#4524) 2026-07-17 17:37:28 -04:00
Jeremiah Lowin
6a6fdcb2bb
 		Repoint tests and examples off removed deprecations 
Replaces FastMCP.as_proxy() helper calls with create_proxy(), rewrites the
mount() as_proxy=/prefix= kwarg tests to plain mount() (the params are gone),
and deletes deprecation-only tests for as_proxy() and remove_tool().
 2026-07-07 07:53:11 -04:00
Jeremiah Lowin
3522a98766
 		Migrate to MCP Python SDK v2 (#4437) 2026-07-06 17:36:45 -04:00
Jeremiah Lowin
a8bb1b08c2
 		Raise fastmcp.ValidationError for invalid tool arguments (#4392) 
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Claude <noreply@anthropic.com>
 2026-06-27 11:14:20 -04:00
Jeremiah Lowin
dc4b0e202d
 		fix(tools): honor serialize_by_alias in tool result serialization (#4391) 2026-06-27 10:24:39 -04:00
Jeremiah Lowin
8e66b0a47a
 		Upgrade ty to 0.0.39 (#4225) 2026-05-30 11:25:05 -04:00
Jeremiah Lowin
e242abee7d
 		Let ToolResult return an error result via is_error (#4217) 2026-05-22 20:20:52 -04:00
Jeremiah Lowin
d8dcc273ca
 		Decouple component imports from server (#4150) 2026-05-15 11:49:08 -04:00
Sarthak Bhardwaj
b8597f941d
 		fix(tool_transform): hoist $defs to schema root when ArgTransform introduces them (#4101) 2026-05-07 11:10:52 -04:00
chaoliang yan
2ffe68cfa1
 		fix: preserve tool decorator metadata (#4072) 
Generated with Codex.

Co-authored-by: lawrence3699 <lawrence3699@users.noreply.github.com>
 2026-05-04 12:22:31 -04:00
Jeremiah Lowin
74efa32edf
 		Add run_in_thread opt-out for sync tools with thread affinity (#4010) 
Co-authored-by: Claude <noreply@anthropic.com>
 2026-04-22 10:31:44 -04:00
Jeremiah Lowin
fa9ad6cb81
 		fix: strip titles from bare-metadata nodes (Gemini 2.5 Flash) (#3881) 2026-04-12 21:06:27 -04:00
Bill Easton
d0bcec979c
 		fix: TransformedTool sync fn crash and schema mutation (#3823) 
* fix: TransformedTool sync fn crash, schema mutation, output_schema=False

- Handle sync transform_fn in run() using is_coroutine_function check
  instead of unconditionally awaiting (fixes TypeError crash)
- Deep copy parent property schemas to prevent mutation corruption
- Accept output_schema=False via BeforeValidator (converts to None)
- Remove inaccurate docstring claiming str/None shorthand for transform_args

Fixes #3821

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add regression tests for sync transform_fn and schema mutation

🤖 Generated with Claude Code

Co-authored-by: Jeremiah Lowin <jeremiah@lowin.dev>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
Co-authored-by: Jeremiah Lowin <jeremiah@lowin.dev>
 2026-04-11 11:50:23 -04:00
Jeremiah Lowin
c397e68d39
 		Update ty ignore comments for 0.0.25 compatibility (#3614) 2026-03-24 20:26:26 -04:00
Jeremiah Lowin
9aa31d57f2
 		fix: suppress output schema for ToolResult subclass annotations (#3548) 
* fix: suppress output schema for ToolResult subclass annotations

* use issubclass_safe/is_class_member_of_type for ToolResult subclass checks

* use parsed_fn.return_type for ToolResult check in transform fallback
 2026-03-18 15:22:37 -04:00
Jeremiah Lowin
360c9c31e5
 		fix: resolve Pyright "Module is not callable" on @tool, @resource, @prompt decorators (#3540) 
* pin pydantic-monty to 0.0.8

* rename tool/prompt/resource base modules to avoid decorator name shadow

* add sys.modules shims for old submodule import paths

* preserve original module paths in deprecation warnings

* clarify when sys.modules shims can be removed
 2026-03-17 18:11:42 -04:00
Jeremiah Lowin
b0b3a6dd95
 		fix: use raw strings for regex in pytest.raises match (#3523) 2026-03-15 15:14:15 -04:00
Jeremiah Lowin
139d2d8f96
 		Propagate x-fastmcp-wrap-result in tool result _meta (#3490) 
* Propagate x-fastmcp-wrap-result flag in tool result _meta

🤖 Generated with Claude Code

Co-authored-by: Claude <noreply@anthropic.com>

* Skip listTools round-trip when _meta has x-fastmcp-wrap-result

🤖 Generated with Claude Code

Co-authored-by: Claude <noreply@anthropic.com>

* Use namespaced meta key: {"fastmcp": {"wrap_result": true}}

🤖 Generated with Claude Code

Co-authored-by: Claude <noreply@anthropic.com>

* Clean up _parse_call_tool_result: hoist cast import, document local CallToolResult import, extract fastmcp_meta

🤖 Generated with Claude Code

Co-authored-by: Claude <noreply@anthropic.com>

* Merge _meta in tasks result handler instead of overwriting

🤖 Generated with Claude Code

* Preserve type validation in meta-based unwrap path

🤖 Generated with Claude Code

* Fix type validation for wrapped task results, guard non-dict meta

🤖 Generated with Claude Code

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2026-03-14 11:09:46 -04:00
Jeremiah Lowin
d316f193a8
 		Fix transform arg collisions with passthrough params (#3431) 
🤖 Generated with GPT-5.2-Codex
 2026-03-07 11:41:07 -05:00
Jeremiah Lowin
ea1328660e
 		Fix NameError with future annotations and Context/Depends parameters (#3243) 
* Fix NameError with future annotations and Context/Depends parameters

Closes #3238, closes #905

* chore: Update SDK documentation

* Drop unnecessary pre-resolution of annotations

Pydantic (even 2.11.7) uses __module__ not __globals__ to resolve
annotations, so setting __module__ alone is sufficient.

* chore: Update SDK documentation

* Restore annotation pre-resolution for Pydantic compat

The wrapper's __globals__ is read-only and points to dependencies.py,
so some Pydantic versions use it instead of __module__ when resolving
string annotations. Pre-resolving via get_type_hints on the original
function ensures annotations are type objects before Pydantic sees them.

* chore: Update SDK documentation

---------

Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
 2026-02-20 09:22:10 -05:00
Jeremiah Lowin
b894a0b747
 		Accept callables in Tool.from_tool() (#3235) 
* Accept callables in Tool.from_tool()

* chore: Update SDK documentation

* Add end-to-end client test for decorated function transform

---------

Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
 2026-02-19 11:31:13 -05:00
Jeremiah Lowin
fe57c3d689
 		Make $ref dereferencing optional via FastMCP(dereference_refs=...) (#3151) 
Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
 2026-02-11 13:45:37 -05:00
Jeremiah Lowin
6a358902f2
 		Fix compress_schema to preserve additionalProperties: false for MCP compatibility (#3102) 
Changes:
- Changed default of prune_additional_properties from True to False in compress_schema
- Added test demonstrating MCP client compatibility requirement
- Updated existing tests to explicitly enable pruning when needed
- Added additionalProperties: false to manually constructed schemas in tool_transform
- Updated inline snapshots to reflect new behavior

Fixes #3008

Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: Jeremiah Lowin <jlowin@users.noreply.github.com>
 2026-02-06 18:52:21 -05:00
Didier Durand
96280b3d2c
 		[Doc]: fixing spelling issues in multiple files 2026-01-23 07:17:38 +01:00
Jeremiah Lowin
c1f50e49be
 		Add enabled field to ToolTransformConfig (#2991) 2026-01-22 17:44:38 -05:00
Jeremiah Lowin
23bfdf0680
 		Consolidate test fixtures and refactor large test files (#2941) 2026-01-19 15:18:35 -05:00
Jeremiah Lowin
d8ab493664
 		Add session-specific visibility control via Context (#2917) 2026-01-18 22:31:06 -05:00
Jeremiah Lowin
c3111a8978
 		Unify discovery API: deduplicate at protocol layer only (#2919) 2026-01-18 21:01:53 -05:00
Jeremiah Lowin
84d7d3b281 Support plural names/keys in enable/disable API 
Change enable() and disable() to accept sets: names, keys, tags.
Use key-based disable for decorator enabled=False to scope exactly.
 2026-01-18 14:58:29 -05:00
Jeremiah Lowin
50ba6ea5a4 Refactor visibility to mark-based enabled system 
Rename Visibility to Enabled, collapse VisibilityRule into the transform,
and move enabled filtering from Provider to Server level so server-level
transforms can override provider-level disables.
 2026-01-18 14:36:33 -05:00
Jeremiah Lowin
6ba5e5d194 Fix type errors and add type ignore comments 
- Add None checks in auth and tool transform tests
- Add assertions in component_service.py for None returns
- Add type ignore comments for max() with version_sort_key
 2026-01-17 07:23:29 -05:00
Jeremiah Lowin
a6cd764b5f
 		Add component versioning and VersionFilter transform (#2894) 2026-01-16 20:53:18 -05:00
Jeremiah Lowin
2d838315f0
 		Add timeout parameter for tool foreground execution (#2872) 2026-01-13 21:05:34 -05:00
Jeremiah Lowin
8c471a499d
 		Run sync tools/resources/prompts in threadpool automatically (#2865) 2026-01-13 11:03:05 -05:00
Jeremiah Lowin
2b6a0faf1c
 		Add loq file size limits and clean up type ignores (#2859) 2026-01-13 07:29:12 -05:00
Jeremiah Lowin
1b723f302d
 		Decorators return functions instead of component objects (#2856) 2026-01-12 21:58:07 -05:00
Jeremiah Lowin
daa2dace2f
 		Add standalone decorators and eliminate fastmcp.fs module (#2832) 2026-01-10 12:16:35 -05:00
Jeremiah Lowin
627c6cdad4
 		Dereference $ref in tool schemas for MCP client compatibility (#2808) 2026-01-07 18:30:08 -05:00
Jeremiah Lowin
a3123176b3
 		Deprecate tool_serializer parameter (#2753) 2025-12-26 16:03:04 -05:00
lif
8d80299f82
 		Fix: resolve root-level $ref in outputSchema for MCP spec compliance (#2720) 2025-12-25 08:42:29 -05:00