fastapi-mcp

What's Changed

Added

• 🚀 Add configurable HTTP header forwarding (#181)

Fixed

• 🐛 Fix a bug with handling FastAPI root_path parameter (#163)

PRs

• update readme by @itay-tadata in #164
• Update readme by @irn77 in #192
• Fix a bug with handling FastAPI root_path parameter by @am1ter in #163
• Add configurable HTTP header forwarding by @floran-putter in #181
• Change fork method in SSE transport tests to avoid pickling issues by @am1ter in #196

New Contributors

• @itay-tadata made their first contribution in #164
• @irn77 made their first contribution in #192
• @am1ter made their first contribution in #163
• @floran-putter made their first contribution in #181

Full Changelog: v0.3.4...v0.3.5

Fixed

• 🐛 Update the mcp dependency to 1.8.1. Fixes Issue #134 that was caused after a breaking change in mcp sdk 1.8.0.

PRs

• Upgrades the mcp package dependency to 1.8.1 by @ierickson in #137
• Fix @modelcontextprotocol/inspector command-line by @bfontaine in #131

New Contributors

• @ierickson made their first contribution in #137
• @bfontaine made their first contribution in #131

Full Changelog: v0.3.3...v0.3.4

Fixes the broken release from 0.3.2.

Fixed

• 🐛 Fix critical bug in openapi conversion (missing param_desc definition) (#107, #99)
• 🐛 Fix non-ascii support (#66)

PRs

• Fix error in openapi conversion by @danlapid in https://github.com/tadata-org/fastapi_mcp/pull/101
• Bugfix/issue 66 by @shira-ayal in https://github.com/tadata-org/fastapi_mcp/pull/90
• add more test cases to openapi conversion by @shahar4499 in https://github.com/tadata-org/fastapi_mcp/pull/109
• bump version to 0.3.3 by @shahar4499 in https://github.com/tadata-org/fastapi_mcp/pull/108

New Contributors

• @danlapid made their first contribution in https://github.com/tadata-org/fastapi_mcp/pull/101

Full Changelog: https://github.com/tadata-org/fastapi_mcp/compare/v0.3.2...v0.3.3

Fixed

• 🐛 Fix a bug preventing simple setup of basic token passthrough

PRs

• Add bearer token example by @shira-ayal in #96
• Fix/bearer token usage by @shahar4499 in #97

Full Changelog: v0.3.1...v0.3.2

🚀 FastApiMCP now supports MCP Authorization!

You can now add MCP-compliant OAuth configuration in a FastAPI-native way, using your existing FastAPI Depends() that we all know and love.

Added

• 🎉 Support for Authentication / Authorization compliant to MCP 2025-03-26 Specification, using OAuth 2.1. (#10)
• 🎉 Support passing http headers to tool calls (#82)

PRs

• Documentation updates by @shira-ayal in #84
• Fix examples links by @ArielRotem1 in #87
• fix: make sure items etc. is passed to mcp tools by @MagnusS0 in #86
• Add Authorization by @shahar4499 in #91

New Contributors

• @ArielRotem1 made their first contribution in #87
• @MagnusS0 made their first contribution in #86

Test Coverage Note

Adding authorization reduced tests coverage significantly, since a lot of auth-related code is not covered by tests at the moment.
This will be fixed, but note that the rest of the API isn't affected by it.
Auth is still in "alpha" stage in FastAPI-MCP.

Full Changelog: v0.3.0...v0.3.1

What's Changed

🚀 FastApiMCP now works with ASGI-transport by default.

This means the base_url argument is redundant, and thus has been removed.

You can still set up an explicit base URL using the http_client argument, and injecting your own httpx.AsyncClient if necessary.

Removed

• ⚠️ Breaking Change: Removed base_url argument since it's not used anymore by the MCP transport.

Fixed

• 🐛 Fix short timeout issue (#71), increasing the default timeout to 10

Merges

• add readme file in Chinese: README_zh-CN.md by @shaom in #73
• HTTP Client Fixes and Improvements by @shahar4499 in #79
• bump version to 0.3.0 by @shahar4499 in #83

New Contributors

• @shaom made their first contribution in #73

Full Changelog: v0.2.0...v0.3.0

Changed (Breaking)

• Complete refactor from function-based API to a new class-based API with FastApiMCP
• Explicit separation between MCP instance creation and mounting with mcp = FastApiMCP(app) followed by mcp.mount()
• FastAPI-native approach for transport providing more flexible routing options
• Updated minimum MCP dependency to v1.6.0

Added

• Support for deploying MCP servers separately from API service
• Support for "refreshing" with setup_server() when dynamically adding FastAPI routes. Fixes Issue #19
• Endpoint filtering capabilities through new parameters:
  • include_operations: Expose only specific operations by their operation IDs
  • exclude_operations: Expose all operations except those with specified operation IDs
  • include_tags: Expose only operations with specific tags
  • exclude_tags: Expose all operations except those with specific tags

Fixed

• FastAPI-native approach for transport. Fixes Issue #28
• Numerous bugs in OpenAPI schema to tool conversion, addressing Issue #40 and Issue #45

Removed

• Function-based API (add_mcp_server, create_mcp_server, etc.)
• Custom tool support via @mcp.tool() decorator

Full Changelog: v0.1.8...v0.2.0

What's Changed

Fixed

• Remove unneeded dependency.

Full Changelog: v0.1.7...v0.1.8

Fixed

• Issue #34: Fix syntax error.

Fixed

• Issue #23: Hide handle_mcp_connection tool.

Fixed

• Issue #25: Dynamically creating tools function so tools are useable.

Fixed

• Issue #8: Converted tools unuseable due to wrong passing of arguments.

Fixed

• Dependency resolution issue with mcp package and pydantic-settings

Changed

• Complete refactor: transformed from a code generator to a direct integration library
• Replaced the CLI-based approach with a direct API for adding MCP servers to FastAPI applications
• Integrated MCP servers now mount directly to FastAPI apps at runtime instead of generating separate code
• Simplified the API with a single add_mcp_server function for quick integration
• Removed code generation entirely in favor of runtime integration

Added

• Main add_mcp_server function for simple MCP server integration
• Support for adding custom MCP tools alongside API-derived tools
• Improved test suite
• Manage with uv

Removed

• CLI interface and all associated commands (generate, run, install, etc.)
• Code generation functionality

Fixed

• Added support for PEP 604 union type syntax (e.g., str | None) in FastAPI endpoints
• Improved type handling in model field generation for newer Python versions (3.10+)
• Fixed compatibility issues with modern type annotations in path parameters, query parameters, and Pydantic models

Added

• Initial release of FastAPI-MCP
• Core functionality for converting FastAPI applications to MCP servers
• CLI tool for generating, running, and installing MCP servers
• Automatic discovery of FastAPI endpoints
• Type-safe conversion from FastAPI endpoints to MCP tools
• Documentation preservation from FastAPI to MCP
• Claude integration for easy installation and use
• API integration that automatically makes HTTP requests to FastAPI endpoints
• Examples directory with sample FastAPI application
• Basic test suite