ceos/fastmcp
1
0
Fork 0
mirror of https://github.com/PrefectHQ/fastmcp.git synced 2026-08-13 09:09:10 +02:00
Code Issues Projects Releases Packages Wiki Activity
3,289 commits 158 branches 115 tags 98 MiB
Commit graph

65 commits

Author SHA1 Message Date
Jeremiah Lowin
3438b77e88 Fix stale docs: update tag filtering API and add output_schema ParamField 2026-02-27 12:10:22 -05:00
Jeremiah Lowin
a2efd686a9
 		Normalize repo references to PrefectHQ/fastmcp casing (#3218) 2026-02-18 14:51:18 -05:00
Jeremiah Lowin
9b248a15b3
 		Update repository references for transfer to prefecthq (#3207) 
* Update repository references from jlowin/fastmcp to prefecthq/fastmcp

* Retrigger CI after repo transfer

* chore: Update SDK documentation

* Only run deep triage on bug issues for jlowin

---------

Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
 2026-02-18 10:33:56 -05:00
Jeremiah Lowin
a307e9c3cc
 		Expose local_provider property, deprecate FastMCP.remove_tool() (#3155) 
Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
 2026-02-11 19:37:19 -06: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
3df38584cf
 		Fix broken documentation links (#2952) 2026-01-19 23:17:29 -05:00
Jeremiah Lowin
0e4d519c86
 		Rename Enabled transform to Visibility (#2950) 2026-01-19 20:46:58 -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
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
1b723f302d
 		Decorators return functions instead of component objects (#2856) 2026-01-12 21:58:07 -05:00
Jeremiah Lowin
8dfa51329a
 		Dereference $ref in tool schemas for MCP client compatibility (#2814) 2026-01-08 21:16:01 -05:00
Jeremiah Lowin
a3123176b3
 		Deprecate tool_serializer parameter (#2753) 2025-12-26 16:03:04 -05:00
Jeremiah Lowin
4de06d7f73
 		Fix documentation to use 'meta' instead of '_meta' for MCP spec field (#2735) 2025-12-25 21:05:11 -05:00
Jeremiah Lowin
1d17334803
 		Reorganize docs around provider architecture (#2723) 2025-12-25 09:00:20 -05:00
Jeremiah Lowin
2f561ec98d
 		Deprecate exclude_args in favor of Depends() (#2621) 
* Deprecate exclude_args in favor of Depends()

* Add version badge to Hiding Parameters section
 2025-12-14 21:24:08 -05:00
Bill Easton
be6b1670d3
 		[Draft] Add documentation for read-only tool patterns (#2536) 
* Add comprehensive documentation for read-only tool patterns

Created new patterns guide explaining readOnlyHint annotation usage,
including practical examples, client-specific behavior, and best
practices for marking tools as read-only.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: William Easton <strawgate@users.noreply.github.com>

* Reorganize read-only tools docs into tools section

Moved read-only tools documentation from standalone patterns page into the tools.mdx file as a "Using Annotation Hints" subsection. Condensed from 218 lines to ~50 lines focusing on practical usage while maintaining essential information about readOnlyHint and other annotations.

Changes:
- Added "Using Annotation Hints" subsection in tools.mdx after MCP Annotations
- Removed docs/patterns/read-only-tools.mdx
- Updated docs.json navigation to remove patterns entry
- Content now positioned as core tool feature rather than advanced pattern

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Bill Easton <strawgate@users.noreply.github.com>

---------

Co-authored-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>
Co-authored-by: William Easton <strawgate@users.noreply.github.com>
 2025-12-09 13:47:29 -05:00
Jeremiah Lowin
83085c3cd3
 		Fix version badges for icons and website_url; add Discord example (#2509) 
* Fix version badges and remove redundant badges from Discord doc

* Add Discord OAuth example
 2025-12-01 13:39:43 -05:00
Jeremiah Lowin
52100b08ff Fix exclude_args with non-serializable types 
Fixes issue #2431 where exclude_args fails when excluded parameters have
non-serializable types (e.g., ServerSession). The fix excludes parameters
from function annotations before Pydantic tries to serialize them.

Also adds deprecation notice that exclude_args will be deprecated in
FastMCP 2.14 in favor of dependency injection.
 2025-11-17 12:25:43 -05:00
Jeremiah Lowin
bbf3050ba7
 		Improve ToolResult and structured output documentation (#2349) 
- Restructured confusing sections: 'Object-like Results' → 'Dictionaries and Objects', 'Non-object Results' → 'Primitives and Collections', 'Complex Type Example' → 'Typed Models'
- Simplified CodeGroup examples to show Tool Definition + MCP Result instead of 3-4 confusing tabs
- Split Primitives/Collections into separate CodeGroups for clarity
- Renamed 'Full Control with ToolResult' → 'ToolResult and Metadata' for better TOC visibility
- Flattened ToolResult documentation with inline field descriptions instead of nested headings
- Added version badge for ToolResult meta field (2.13.1)
- Added clarification that ToolResult meta is separate from @mcp.tool meta
- Improved example server with realistic metadata (execution time, character/word counts)
- Fixed code formatting (multi-line objects, trailing commas)
 2025-11-02 17:07:48 -05:00
Brandon Shar
c18782f02b
 		Add meta support to ToolResult (#2283) 
* Add meta to ToolResult

* add this at the client level and test the full integration

* add example

* slipped through linting somehow

---------

Co-authored-by: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
 2025-11-02 16:46:52 -05:00
hyeonjae
24e2b09d95
 		Update content type in advanced_tool function (#2147) 2025-10-20 08:43:35 -04:00
Jeremiah Lowin
6f627b58fd
 		Implement icon support (#2121) 
* Implement icon support in fastmcp

* Fix icon feature tests

- Update snapshot for ResourceTemplate to include icons field
- Remove OAuth mounting tests (belong to PR #2119, not this feature)

* Update docs
 2025-10-17 17:28:08 -04:00
Jeremiah Lowin
2f841c356e
 		Document container limitations for Image/Audio/File objects (#2118) 2025-10-16 18:03:29 -04:00
Jeremiah Lowin
e036cba383
 		Add Pydantic-compatible input validation (#2073) 2025-10-14 11:49:30 -07:00
Jeremiah Lowin
3fc2510110
 		Add meta parameter support to tools, resources, templates, and prompts decorators (#1294) 2025-07-29 17:16:05 -04:00
Jeremiah Lowin
0691701951
 		Add _fastmcp meta namespace (#1290) 2025-07-29 15:07:53 -04:00
Jeremiah Lowin
160d50e3a5 Update documentation 2025-07-28 17:42:23 -04:00
Jeremiah Lowin
d04840560a
 		Support string annotations (#1255) 2025-07-24 14:28:58 -04:00
Jeremiah Lowin
f4c0beca27
 		Update docs to reflect sync tools (#1234) 2025-07-22 19:04:38 -04:00
Jeremiah Lowin
c412a63d4e Update docs 2025-06-27 22:38:55 -04:00
Jeremiah Lowin
1e29149d5f Merge branch 'main' into output-schema 2025-06-26 19:30:35 -04:00
Jeremiah Lowin
7b9696405b Remove legacy json parsing 
Because the server now validates inputs, its no longer viable to provide a JSON string where e.g. an array is expected, so we can entirely remove FastMCP's "legacy json parsing" support from 1.x.

This is a breaking change (for legacy opt-in behavior)
 2025-06-26 18:19:43 -04:00
Jeremiah Lowin
38036b1f42 Add automatic MCP list change notifications and client message handling 
Implements comprehensive notification system for tools, resources, and prompts with automatic client updates and flexible message handlers.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-24 22:33:06 -04:00
Jeremiah Lowin
44f14b1f7b Clean up parameter documentation 2025-06-22 20:59:53 -04:00
Jeremiah Lowin
4b77c3a405 Add docs 2025-06-20 18:23:47 -04:00
Goro
058ebdd16f Add file tool return value doc 2025-06-16 07:40:06 +02:00
Jeremiah Lowin
06dcff3b3b Add tests 2025-06-14 09:22:29 -04:00
Jeremiah Lowin
46ab813de6 Deprecate top-level import 2025-06-14 09:12:21 -04:00
Jeremiah Lowin
233c4fb3fb Add docs 2025-06-10 11:06:31 -04:00
Jeremiah Lowin
5a0f57498f remove empty parens from tool 2025-06-05 14:55:32 -04:00
Jeremiah Lowin
b3f80c5374 Add empty parens to docs 2025-06-04 17:39:57 -04:00
Jeremiah Lowin
d1549c3d35 Remove empty parens 2025-06-04 15:37:55 -04:00
Jeremiah Lowin
8a61b16cda Document exclude_args 2025-06-01 18:14:57 -04:00
Jeremiah Lowin
53b067b4e7 Make error masking configurable 2025-05-22 09:08:16 -04:00
Jeremiah Lowin
79ffb3e8bc Add documentation for tool removal 2025-05-13 18:47:21 -04:00
Jeremiah Lowin
6fa7c1704a Improve error handling for tools and resources 2025-05-13 14:19:55 -04:00
Jeremiah Lowin
112b91f521 create a setting for legacy parsing 2025-05-06 13:21:38 -04:00