FastAPI SSE MCP Random

A FastAPI server that implements the Model Context Protocol (MCP) using Server-Sent Events (SSE) for streaming communication. This project provides various utility tools including random number generation, image generation using Azure OpenAI DALL-E, and AI podcast generation.

Features

Server-Sent Events (SSE) for real-time streaming communication
Model Context Protocol (MCP) implementation for structured tool use
Multiple utility tools:
- Echo tool and resources
- Random number generator
- Image generation via Azure OpenAI DALL-E 3
- AI podcast generation
- "Think tool" for reflective responses

Prerequisites

Python 3.10+
Azure OpenAI API access (for image generation)

Installation

Clone the repository:

git clone <repository-url>
cd fastapi_sse_mcp_random

Install the dependencies:

pip install -r requirements.txt

Or using uv:

uv pip install -e .

Usage

Starting the server

Run the server with:

python main.py

The server will start at http://0.0.0.0:8000

Available Endpoints

GET /: Health check endpoint
GET /sse/: SSE connection endpoint
POST /messages/: Endpoint for client messages

Available Tools

Echo Tool

{
  "name": "echo_tool",
  "parameters": {
    "message": "Hello, world!"
  }
}

Random Number Generator

{
  "name": "random_number",
  "parameters": {
    "min_value": 1,
    "max_value": 100
  }
}

Image Generation

{
  "name": "generate_image",
  "parameters": {
    "prompt": "A beautiful landscape with mountains and a lake"
  }
}

Podcast Generation

{
  "name": "generate_podcast",
  "parameters": {
    "prompt": "The future of artificial intelligence",
    "duration": 5,
    "name1": "Mark",
    "voice1": "Thomas",
    "name2": "Sophia",
    "voice2": "Emily"
  }
}

Think Tool

{
  "name": "think_tool",
  "parameters": {
    "input": "What are the implications of quantum computing?"
  }
}

Project Structure

main.py: Main FastAPI application and MCP tools implementation
sse.py: Server-Sent Events (SSE) implementation
pyproject.toml: Project metadata and dependencies
requirements.txt: Basic dependencies list

Dependencies

FastAPI: Web framework for building APIs
MCP: Model Context Protocol implementation
OpenAI: Client for Azure OpenAI services
Uvicorn: ASGI server for running FastAPI applications
Requests: HTTP library for API calls

License

[Specify your license here]

Contributing

[Instructions for contributing to the project]

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A FastAPI server implementing the Model Context Protocol (MCP) for structured tool use, providing utility tools including random number generation, image generation via Azure OpenAI DALL-E, and AI podcast generation.

Related MCP Servers

MCP Server Replicate
gerred
A
security
F
license
A
quality
A FastMCP server implementation that facilitates resource-based access to AI model inference, focusing on image generation through the Replicate API, with features like real-time updates, webhook integration, and secure API key management.
Last updated -
18
15
Python
MyAIServ MCP Server
eagurin
-
security
A
license
-
quality
A high-performance FastAPI server supporting Model Context Protocol (MCP) for seamless integration with Large Language Models, featuring REST, GraphQL, and WebSocket APIs, along with real-time monitoring and vector search capabilities.
Last updated -
9
Python
MIT License
Awesome MCP FastAPI
MR-GREEN1337
-
security
F
license
-
quality
A production-ready MCP server built with FastAPI, providing an enhanced tool registry for creating, managing, and documenting AI tools for Large Language Models (LLMs).
Last updated -
32
Python
MCP Server for Replicate
tzafrir
-
security
A
license
-
quality
A FastMCP server implementation that provides a standardized interface for accessing AI models hosted on Replicate's API, currently supporting image generation with customizable parameters.
Last updated -
3
Python
MIT License

View all related MCP servers