FastAPI MCP Server

FastAPI MCP Server

A Model Context Protocol (MCP) server that provides comprehensive tools for introspecting and working with FastAPI applications.

Features

🔧 Tools

1. load_fastapi_app - Load a FastAPI application from a module path
2. list_routes - List all routes with optional filtering
3. get_route_details - Get comprehensive details about a specific route
4. get_openapi_schema - Extract the OpenAPI schema
5. list_models - List all Pydantic models used in the app
6. get_model_schema - Get detailed schema for a specific model
7. search_routes - Search routes by query and criteria
8. analyze_dependencies - Analyze dependency injection usage
9. get_route_source - View the source code of route handlers

Installation

pip install -e .

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "fastapi": {
      "command": "python",
      "args": [
        "-m",
        "fastapi_mcp_server.server"
      ],
      "cwd": "/path/to/your/fastapi/project"
    }
  }
}

Standalone

# From your FastAPI project directory
python -m fastapi_mcp_server.server

Example Usage

1. Load Your FastAPI App

Tool: load_fastapi_app
Arguments: {"app_path": "main:app"}

2. List All Routes

Tool: list_routes
Arguments: {}

Or with filters:

Tool: list_routes
Arguments: {
  "method_filter": "GET",
  "tag_filter": "users"
}

3. Get Route Details

Tool: get_route_details
Arguments: {
  "path": "/users/{user_id}",
  "method": "GET"
}

4. Search for Routes

Tool: search_routes
Arguments: {
  "query": "authentication",
  "has_auth": true
}

5. View Route Source Code

Tool: get_route_source
Arguments: {
  "path": "/users",
  "method": "POST"
}

6. List All Models

Tool: list_models
Arguments: {}

7. Get Model Schema

Tool: get_model_schema
Arguments: {"model_name": "User"}

8. Get OpenAPI Schema

Tool: get_openapi_schema
Arguments: {}

Or for specific paths:

Tool: get_openapi_schema
Arguments: {
  "include_only": ["/users", "/users/{user_id}"]
}

9. Analyze Dependencies

Tool: analyze_dependencies
Arguments: {}

Example FastAPI App

See example_app.py for a sample FastAPI application to test with.

Use Cases

🔍 **API Discovery**

• Quickly understand what endpoints exist
• Find routes by functionality or path
• Explore API structure

📚 **Documentation Generation**

• Extract OpenAPI schemas
• Get detailed parameter information
• View model schemas with examples

🐛 **Debugging**

• Inspect route configurations
• View dependency injection hierarchy
• Check parameter validations

🔨 **Development**

• Generate client code from schemas
• Understand existing APIs before modification
• Find all routes using specific models

🧪 **Testing**

• List all endpoints for test coverage
• Get parameter requirements for test cases
• Validate response models

Requirements

• Python 3.10+
• FastAPI 0.100.0+
• MCP 1.0.0+
• Pydantic 2.0.0+

Contributing

Contributions are welcome! This tool helps developers work more efficiently with FastAPI applications.

License

MIT License - feel free to use in your projects!

Author

Created as part of the FastAPI ecosystem to improve developer experience with AI-assisted development.