contrib package that holds community-contributed modules. These modules extend FastMCP’s functionality but aren’t officially maintained by the core team.
Contrib modules provide additional features, integrations, or patterns that complement the core FastMCP library. They offer a way for the community to share useful extensions while keeping the core library focused and maintainable.
The available modules can be viewed in the contrib directory.
Usage
To use a contrib module, import it from thefastmcp.contrib package:
Important Considerations
- Stability: Modules in
contribmay have different testing requirements or stability guarantees compared to the core library. - Compatibility: Changes to core FastMCP might break modules in
contribwithout explicit warnings in the main changelog. - Dependencies: Contrib modules may have additional dependencies not required by the core library. These dependencies are typically documented in the module’s README or separate requirements files.
Contributing
Contrib modules are accepted selectively. Before opening a PR, first open an issue with the problem, intended maintenance model, and why the pattern belongs in-repo instead of a standalone package. If maintainers agree it belongs incontrib, prepare the module with:
- Create a new directory in
fastmcp_slim/fastmcp/contrib/for your module - Add proper tests for your module in
tests/contrib/ - Include comprehensive documentation in a README.md file, including usage and examples, as well as any additional dependencies or installation instructions
- Submit a focused pull request linked to the maintainer-approved issue
- Solves a specific use case or integration need
- Follows FastMCP coding standards
- Includes thorough documentation and examples
- Has comprehensive tests
- Specifies any additional dependencies