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
Create a virtual environment
Install dependencies
Starting the Server in SSE Mode
Start the server using the uv run command:
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:
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 /
: HomepageGET /about
: Information about the applicationGET /status
: Current server statusGET /sse
: SSE endpoint for MCP communicationGET /docs
: API documentation (Swagger UI)GET /redoc
: Alternative API documentation (ReDoc)
License
This server cannot be installed
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),以按需或以连续流的形式提供随机猫事实。
Related MCP Servers
- -securityAlicense-qualityA 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 -9MIT License
- -securityAlicense-qualityA 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 -49MIT License
- -securityFlicense-qualityA 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
- -securityFlicense-qualityA 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 -