FastAPI-MCP

""" This example shows how to customize exposing endpoints by filtering operation IDs and tags. Notes on filtering: - You cannot use both `include_operations` and `exclude_operations` at the same time - You cannot use both `include_tags` and `exclude_tags` at the same time - You can combine operation filtering with tag filtering (e.g., use `include_operations` with `include_tags`) - When combining filters, a greedy approach will be taken. Endpoints matching either criteria will be included """ from examples.shared.apps.items import app # The FastAPI app from examples.shared.setup import setup_logging from fastapi_mcp import FastApiMCP setup_logging() # Examples demonstrating how to filter MCP tools by operation IDs and tags # Filter by including specific operation IDs include_operations_mcp = FastApiMCP( app, name="Item API MCP - Included Operations", include_operations=["get_item", "list_items"], ) # Filter by excluding specific operation IDs exclude_operations_mcp = FastApiMCP( app, name="Item API MCP - Excluded Operations", exclude_operations=["create_item", "update_item", "delete_item"], ) # Filter by including specific tags include_tags_mcp = FastApiMCP( app, name="Item API MCP - Included Tags", include_tags=["items"], ) # Filter by excluding specific tags exclude_tags_mcp = FastApiMCP( app, name="Item API MCP - Excluded Tags", exclude_tags=["search"], ) # Combine operation IDs and tags (include mode) combined_include_mcp = FastApiMCP( app, name="Item API MCP - Combined Include", include_operations=["delete_item"], include_tags=["search"], ) # Mount all MCP servers with different paths include_operations_mcp.mount_http(mount_path="/include-operations-mcp") exclude_operations_mcp.mount_http(mount_path="/exclude-operations-mcp") include_tags_mcp.mount_http(mount_path="/include-tags-mcp") exclude_tags_mcp.mount_http(mount_path="/exclude-tags-mcp") combined_include_mcp.mount_http(mount_path="/combined-include-mcp") if __name__ == "__main__": import uvicorn print("Server is running with multiple MCP endpoints:") print(" - /include-operations-mcp: Only get_item and list_items operations") print(" - /exclude-operations-mcp: All operations except create_item, update_item, and delete_item") print(" - /include-tags-mcp: Only operations with the 'items' tag") print(" - /exclude-tags-mcp: All operations except those with the 'search' tag") print(" - /combined-include-mcp: Operations with 'search' tag or delete_item operation") uvicorn.run(app, host="0.0.0.0", port=8000)