Python MCP Cat Facts

A FastAPI server that implements the Model Context Protocol (MCP) using Server-Sent Events (SSE) transport to provide cat facts.

Features

Get a single random cat fact
Subscribe to a stream of cat facts delivered every 10 seconds
SSE (Server-Sent Events) for real-time communication
FastAPI framework with automatic OpenAPI documentation

Requirements

Python 3.12+
Dependencies:
- fastapi
- mcp[cli]
- uvicorn
- cmake

Installation

Clone the repository

git clone <repository-url>
cd python-mcp

Create a virtual environment

python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate

Install dependencies

pip install -e .

Starting the Server in SSE Mode

Start the server using the uv run command:

uv run start

Once the server is running, it will be available at:

API: http://localhost:8000
API Documentation: http://localhost:8000/docs

VS Code Integration

To use this MCP server with VS Code, you need to add the following configuration to your mcp.json file:

{
    "servers": {
        "mcp-sse": {
            "type": "sse",
            "url": "http://0.0.0.0:8000/sse"
        }
    }
}

This configuration tells VS Code how to connect to your MCP server using SSE transport.

Using the Cat Facts API

Get a single cat fact:

Connect to the SSE endpoint and request a single cat fact. The response will always start with "Hi!".

API Endpoints

GET /: Homepage
GET /about: Information about the application
GET /status: Current server status
GET /sse: SSE endpoint for MCP communication
GET /docs: API documentation (Swagger UI)
GET /redoc: Alternative API documentation (ReDoc)

License

MIT

This server cannot be installed

security - not tested

license - not found

quality - not tested

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 that implements the Model Context Protocol (MCP) using Server-Sent Events (SSE) transport to provide random cat facts on demand or as a continuous stream.

Related MCP Servers

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 -
5
Python
MIT License
FastAPI MCP SSE
panz2018
-
security
A
license
-
quality
A Server-Sent Events implementation using FastAPI framework that integrates Model Context Protocol (MCP), allowing AI models to access external tools and data sources like weather information.
Last updated -
9
Python
MIT License
Basic MCP Application
priteshshah96
-
security
F
license
-
quality
A simple application demonstrating Model Context Protocol (MCP) integration with FastAPI and Streamlit, allowing users to interact with LLMs through a clean interface.
Last updated -
3
Python
MCP SSE Server
aihes
A
security
F
license
A
quality
An implementation of the Model Context Protocol (MCP) server using Server-Sent Events (SSE) for real-time communication, providing tools for calculations and dynamic resource templates.
Last updated -
1
JavaScript

View all related MCP servers

Python MCP Cat Facts