Python MCP Cat Facts

by akream
  • Linux
  • Apple

Integrations

  • Provides a FastAPI-based server implementation that exposes cat facts data through SSE transport, complete with automatic OpenAPI documentation.

  • Integrates with Swagger UI to provide interactive API documentation, allowing users to explore and test the cat facts endpoints.

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:

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

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Features
    1. Requirements
      1. Installation
        1. Clone the repository
        2. Create a virtual environment
        3. Install dependencies
      2. Starting the Server in SSE Mode
        1. VS Code Integration
          1. Using the Cat Facts API
            1. Get a single cat fact:
          2. API Endpoints
            1. License

              Related MCP Servers

              • -
                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
              • -
                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
              • -
                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
                • Linux
              • 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

              ID: 4sslfgnx26