Fastapi MCP Sse

🚀 FastAPI MCP SSE Implementation

This project implements Server-Sent Events (SSE) using the FastAPI framework and integrates the Model Context Protocol (MCP).

🚀 Quick Start

This project demonstrates how to use Server-Sent Events (SSE) in the FastAPI framework and integrate the Model Context Protocol (MCP) functionality. The key feature is the seamless integration of MCP's SSE capabilities into a complete FastAPI web application with custom routes.

✨ Features

• SSE implementation with MCP.
• Integration of the FastAPI framework with custom routes.
• A unified web application with both MCP and standard web endpoints.
• Customizable routing structure.
• Clear separation of responsibilities between MCP functionality and web functionality.

🔧 Technical Details

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI models to interact with external tools and data sources. MCP addresses several key challenges in AI development:

• Context Limitation: Allows models to access up-to-date information beyond their training data.
• Tool Integration: Provides a standardized way for models to use external tools and APIs.
• Interoperability: Creates a common interface between different AI models and tools.
• Scalability: Facilitates the addition of new features to AI systems without retraining.

This project shows how to implement MCP using SSE in a FastAPI web application.

Architecture

This project demonstrates a modular architecture:

1. Integrate MCP SSE endpoints (/sse and /messages/) into the FastAPI application.
2. Provide standard web routes (/, /about, /status, /docs, /redoc).
3. Demonstrate how to keep MCP functionality separate from web routes.

📦 Installation

Dependencies

Install the UV Package Manager - a fast Python package installation tool written in Rust:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Option 1: Quick Run Without Installation

Run the application directly using the UV execution tool:

uvx --from git+https://github.com/panz2018/fastapi_mcp_sse.git start

Option 2: Full Installation

Create a Virtual Environment

Create an isolated Python environment for the project:

uv venv

Activate the Virtual Environment

Activate the virtual environment to use it:

.venv\Scripts\activate

Install Dependencies

Install all required packages:

uv pip install -r pyproject.toml

Start the Integrated Server

Start the FastAPI server with MCP SSE functionality:

python src/server.py

Or

uv run start

Available Endpoints

After starting the server (either using Option 1 or Option 2), the following endpoints will be available:

• Main Server: http://localhost:8000
• Standard Web Routes:
  • Home Page: http://localhost:8000/
  • About Page: http://localhost:8000/about
  • Status API: http://localhost:8000/status
  • Documentation (Swagger UI): http://localhost:8000/docs
  • Documentation (ReDoc): http://localhost:8000/redoc
• MCP SSE Endpoints:
  • SSE Endpoint: http://localhost:8000/sse
  • Message Publishing: http://localhost:8000/messages/

Integration with Continue

To use this MCP server with the Continue VS Code extension, add the following configuration to your Continue settings:

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "name": "weather",
          "type": "sse",
          "url": "http://localhost:8000/sse"
        }
      }
    ]
  }
}