README.md•1.58 kB
# 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:
```bash
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:
```json
{
"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](https://jokeapi.dev/)
- Quotes: [Zen Quotes API](https://zenquotes.io/)
- Facts: [Useless Facts API](https://uselessfacts.jsph.pl/)
- Advice: [Advice Slip API](https://api.adviceslip.com/)
## Development
To test the server locally without Claude Desktop, you can use the MCP Inspector:
```bash
npx @modelcontextprotocol/inspector node index.js
```
This will open a web interface where you can test all the available tools.