Skip to main content
Glama

Python MCP Cat Facts

by akream

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

-
security - not tested
F
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.

一个 FastAPI 服务器,它使用服务器发送事件 (SSE) 传输实现模型上下文协议 (MCP),以按需或以连续流的形式提供随机猫事实。

  1. 特征
    1. 要求
      1. 安装
        1. 克隆存储库
        2. 创建虚拟环境
        3. 安装依赖项
      2. 以 SSE 模式启动服务器
        1. VS Code 集成
          1. 使用 Cat Facts API
            1. 了解一只猫的概况:
          2. API 端点
            1. 执照

              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 -
                9
                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 -
                49
                MIT License
              • -
                security
                F
                license
                -
                quality
                A server for Model Context Protocol (MCP) that uses Server-Sent Events (SSE) for streaming communication, enabling tools like the HackerNews API to be accessed through a secure HTTP+SSE transport.
                Last updated -
                23
              • -
                security
                F
                license
                -
                quality
                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.
                Last updated -

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/akream/mcppython'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server