CatMCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@CatMCP tell me a funny cat joke"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CatMCP
/\_/\
( o.o ) [ BETA ]
> ^ <
_ / \ _
( ) ( )
` ` ` `
\__/\_/CatMCP is a lightweight, playful, and fully standard-compliant Model Context Protocol (MCP) server that serves a curated collection of hilarious cat jokes to LLM clients (like Claude Desktop, Cursor, and more). Whether you need tech puns, classic question-and-answers, silly scenarios, or workplace meow-ments, CatMCP has you covered!
π Features
Purr-fect Joke Database: Hand-crafted collection of 24 cat jokes categorized by themes.
Categorized Selections: Easily request jokes filtered by category (
tech,classic,puns,silly,work).Flexible Searching: Full-text case-insensitive search across the entire joke database.
Rich Resources:
jokes://all: Read the complete dataset in JSON format.jokes://categories: Read a summary of all categories and their joke counts.jokes://random: Fetch a dynamic random joke in raw text format.
Creative Prompts: Integrate interactive prompt templates like
tell_cat_joketo turn LLMs into cat-loving stand-up comedians.Robustly Tested: Built using
fastmcpwith comprehensive unit tests for high reliability.
Related MCP server: Microsoft Copilot Studio MCP
π Quick Start
Prerequisites
Python:
>=3.12uv (Recommended package manager): Install uv
Installation
Clone the repository and install dependencies using uv:
# Clone the repository
git clone https://github.com/Perseu/catmcp.git
cd catmcp
# Install dependencies and create a virtual environment
uv syncRunning the Server
You can start the MCP server using standard IO (stdio) transport:
uv run python main.pyπ οΈ MCP Capabilities
1. Tools
get_random_joke(category: Optional[str]): Retrieve a random cat joke. You can filter by category:tech,classic,puns,silly, orwork.list_categories(): Get a sorted list of all available joke categories.search_jokes(keyword: str): Case-insensitive text search across joke setups, punchlines, and categories.
2. Resources
jokes://all: Serves the entire joke database as a static JSON resource.jokes://categories: Serves the category distribution and count summary as a JSON resource.jokes://random: Serves a dynamic random cat joke in plain text format.
3. Prompts
tell_cat_joke(category: Optional[str], tone: Optional[str]): Generates a standard instruction set directing the AI client to perform the joke under a specified persona (e.g.CatComedian) and tone (e.g.sarcastic,enthusiastic,dry).
βοΈ Host Configuration
To integrate CatMCP with your favorite LLM client, add the server to your configuration file.
Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"catmcp": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/catmcp",
"run",
"python",
"main.py"
]
}
}
}Cursor
Go to Settings > Features > MCP.
Click + Add New MCP Server.
Fill in the fields:
Name:
CatMCPType:
commandCommand:
uv --directory "/absolute/path/to/catmcp" run python main.py
π§ͺ Testing
CatMCP uses pytest for testing. You can run all 11 unit tests to verify server tools, resources, and prompts:
uv run pytestπ License
This project is licensed under the MIT License. See the LICENSE file for details.
Created with πΎ by Perseu.
Available Tools
3 toolsget_random_jokeB
Retrieve a random cat joke.
Inputs: category. Returns: result
list_categoriesA
Get a list of all available cat joke categories.
Inputs: no named parameters. Returns: result
search_jokesA
Search jokes for a specific keyword in the setup or punchline.
Inputs: keyword (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: retrieving a random joke, listing categories, and searching jokes by keyword. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern: get_random_joke, list_categories, search_jokes. This makes the API predictable and easy to navigate.
With only 3 tools, the server is tightly scoped and each tool earns its place. The count is appropriate for a focused cat joke service.
The tool set covers the core needs of a joke API: random access, category browsing, and keyword search. There are no obvious missing operations for the stated purpose.
Maintenance
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceAn MCP server that delivers various joke types (Chuck Norris, Dad jokes, etc.) to Microsoft Copilot Studio and GitHub Copilot, allowing users to request specific joke categories through natural language.-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that enables integration of joke delivery capabilities into Microsoft Copilot Studio and GitHub Copilot, allowing users to request and receive various types of jokes through natural language.MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that delivers various categories of jokes (Chuck Norris, Dad jokes, etc.) when integrated with Microsoft Copilot Studio or GitHub Copilot.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides jokes on demand, allowing users to request different types of jokes (Chuck Norris, Dad jokes, etc.) through natural language in both GitHub Copilot and Microsoft Copilot Studio.MIT