Futurama Quote Machine MCP Server
A simple connector that lets you interact with Futurama quotes directly through Claude Desktop! No need to switch between apps - just ask Claude to find quotes, add new ones, or manage your collection.
What This Does
This tool connects Claude Desktop to the Futurama Quote Machine API, giving you these superpowers:
🎲 Get random quotes - "Give me a random Futurama quote"
🔍 Search quotes - "Find quotes from Bender about robots"
📝 Add new quotes - "Add this quote: 'Shut up and take my money!' by Fry"
✏️ Edit quotes - "Update quote 123 to fix that typo"
🗑️ Delete quotes - "Remove quote 456"
👥 List characters - "What characters have quotes?"
Quick Start (5 Minutes)
Step 1: Download This Project
Option A: Download ZIP
Click the green "Code" button above
Click "Download ZIP"
Unzip to your Desktop
Option B: Clone with Git
Step 2: Set Up Python
On Mac:
On Windows:
Step 3: Configure Claude Desktop
On Mac:
On Windows:
Step 4: Update the Configuration
Edit the config file you just copied and change the path to match where you put this project:
Replace
Mac:
/Users/yourname/Desktop/futurama-quote-machine-mcp/run_server.sh
Windows:
C:\Users\YourName\Desktop\futurama-quote-machine-mcp\run_server.bat
Step 5: Start Using It!
Restart Claude Desktop (important!)
Try these commands:
"Get me a random Futurama quote"
"Show me quotes from Professor Farnsworth"
"What characters have quotes?"
"Add a new quote: 'Bite my shiny metal ass!' by Bender"
Detailed Installation Guide
Prerequisites
Python 3.8 or newer - Download here
Claude Desktop app - Download here
Internet connection (to fetch quotes from the API)
Installation Steps
Check if Python is installed:
python --version # or try: python3 --versionYou should see something like "Python 3.9.7" or newer.
Download this project:
Download the ZIP file and extract it, OR
Use
git clone
if you know Git
Open Terminal/Command Prompt:
Mac: Press Cmd+Space, type "Terminal"
Windows: Press Win+R, type "cmd"
Navigate to the project folder:
cd /path/to/futurama-quote-machine-mcpCreate a virtual environment:
# Mac/Linux: python3 -m venv venv source venv/bin/activate # Windows: python -m venv venv venv\Scripts\activateInstall required packages:
pip install mcp httpxMake the script executable (Mac/Linux only):
chmod +x run_server.shTest the server:
# Mac/Linux: ./run_server.sh # Windows: run_server.batIf it works, you'll see no errors and it will wait for connections.
Configure Claude Desktop:
Find your Claude Desktop configuration file:
Mac:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
If the file doesn't exist, create it. Add this content (update the path):
{ "mcpServers": { "futurama-quote-machine": { "command": "/FULL/PATH/TO/YOUR/PROJECT/run_server.sh", "args": [], "env": {} } } }Restart Claude Desktop and test!
Usage Examples
Once everything is set up, you can chat naturally with Claude:
Getting Quotes
"Give me a random Futurama quote"
"Show me 5 quotes from Bender"
"Find quotes about robots"
"What did Professor Farnsworth say about science?"
Managing Quotes
"Add this quote: 'Woo! Go team!' by Bender"
"Update quote 42 to say 'Good news, everyone!' by Professor Farnsworth"
"Delete quote 123"
Exploring the Database
"How many quotes are there total?"
"What characters have quotes?"
"Show me page 2 of quotes"
Troubleshooting
"Server not found" or "Connection failed"
Check the path in your config file - Make sure it points to where you actually put the project
Restart Claude Desktop after any config changes
Test the server manually by running
./run_server.sh
in Terminal
"Python not found" errors
Install Python from python.org
Make sure it's in your PATH - try
python3
instead ofpython
"Permission denied" (Mac/Linux)
"Module not found" errors
Make sure you activated the virtual environment and installed the packages:
Still having issues?
Check the Claude Desktop logs - Look for error messages when the server starts
Test the API directly - Visit https://fqm.jeremyschroeder.net/api/ in your browser
Create an issue on this GitHub repository with:
Your operating system
Python version (
python --version
)The exact error message
Customization
Using a Different API
To connect to your own Futurama Quote Machine API:
Edit
server.py
Change this line:
API_BASE_URL = "https://your-api-url.com/api"
Adding New Features
The server code is well-documented. Look at the handler functions in server.py
to see how to add new quote operations.
File Structure
API Reference
This MCP server connects to a Futurama Quote Machine API with these endpoints:
GET /quotes
- List quotes (with pagination and filtering)GET /random
- Get a random quoteGET /{id}
- Get specific quote by IDPOST /quotes
- Create new quotePUT /{id}
- Update existing quoteDELETE /{id}
- Delete quoteGET /characters
- List all characters
For full API documentation, visit: https://fqm.jeremyschroeder.net/api/
Contributing
Want to help improve this project?
Fork this repository
Create a feature branch (
git checkout -b feature/amazing-feature
)Make your changes
Test thoroughly
Submit a pull request
Ideas for contributions:
Windows batch script improvements
Better error handling
Additional quote operations
Integration with other quote APIs
Improved documentation
License
This project is licensed under the MIT License - see the LICENSE file for details.
Related Projects
Futurama Quote Machine - The original Flask web app
MCP Official Documentation - Learn more about Model Context Protocol
Claude Desktop - Download the Claude Desktop app
Support
🐛 Found a bug? Create an issue
💡 Have an idea? Start a discussion
📚 Need help? Check the troubleshooting section above
Made with ❤️ for the Futurama and Claude communities!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables interaction with Futurama quotes through Claude Desktop by connecting to the Futurama Quote Machine API. Supports getting random quotes, searching by character, adding new quotes, editing existing ones, and managing the quote collection through natural language.
Related MCP Servers
- AsecurityAlicenseAqualityEnables interaction with the Things app through Claude Desktop, allowing task creation, project analysis, and priority management using natural language commands.Last updated -22132MIT License
- AsecurityAlicenseAqualityEnables natural language interaction with Azure services through Claude Desktop, supporting resource management, subscription handling, and tenant selection with secure authentication.Last updated -9215MIT License
- AsecurityAlicenseAqualityA server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.Last updated -3193MIT License
- AsecurityAlicenseAqualityEnables Claude Desktop and other AI tools to interact directly with Figma, allowing for powerful AI-assisted design capabilities through natural language commands.Last updated -43204200MIT License