Fun MCP Server

A Model Context Protocol (MCP) server that provides various fun tools for Claude Desktop. Get random jokes, quotes, facts, and advice!

Features

• 🎭 Random Jokes (clean, family-friendly)
• 💭 Random Inspirational Quotes
• 🎓 Random Interesting Facts
• 💡 Random Advice

Setup

1. Clone this repository
2. Install dependencies:

npm install

Configuration for Claude Desktop

1. Open Claude Desktop
2. Click on Settings (gear icon in top left)
3. Go to the Developer tab
4. Click "Edit Config"
5. Add the following configuration:

{
  "mcpServers": {
    "fun": {
      "command": "node",
      "args": [
        "/FULL/PATH/TO/index.js"
      ]
    }
  }
}

Replace /FULL/PATH/TO/index.js with the actual full path to your index.js file. For example: /Users/username/projects/fun-mcp-server/index.js

Usage

After setting up, restart Claude Desktop. You can then use the following commands:

• "Tell me a joke"
• "Share an inspirational quote"
• "Give me an interesting fact"
• "What advice do you have for me?"

API Credits

This server uses the following APIs:

• Jokes: JokeAPI
• Quotes: Zen Quotes API
• Facts: Useless Facts API
• Advice: Advice Slip API

Development

To test the server locally without Claude Desktop, you can use the MCP Inspector:

npx @modelcontextprotocol/inspector node index.js

This will open a web interface where you can test all the available tools.