Skip to main content
Glama

Futurama Quote Machine MCP Server

by BitsofJeremy
GitHub
Python
MIT License
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. Click the green "Code" button above
  2. Click "Download ZIP"
  3. Unzip to your Desktop

Option B: Clone with Git

git clone https://github.com/BitsofJeremy/futurama-quote-machine-mcp.git cd futurama-quote-machine-mcp

Step 2: Set Up Python

On Mac:

# Install Python if you don't have it (using Homebrew) /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew install python # Create virtual environment python3 -m venv venv source venv/bin/activate # Install requirements pip install mcp httpx

On Windows:

# Download Python from python.org if you don't have it # Create virtual environment python -m venv venv venv\Scripts\activate # Install requirements pip install mcp httpx

Step 3: Configure Claude Desktop

On Mac:

# Copy the configuration file mkdir -p ~/Library/Application\ Support/Claude cp claude_desktop_config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

On Windows:

# Copy the configuration file mkdir %APPDATA%\Claude copy claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json

Step 4: Update the Configuration

Edit the config file you just copied and change the path to match where you put this project:

{ "mcpServers": { "futurama-quote-machine": { "command": "/PATH/TO/YOUR/PROJECT/run_server.sh", "args": [], "env": {} } } }

Replace /PATH/TO/YOUR/PROJECT/ with your actual path, like:

  • 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!

  1. Restart Claude Desktop (important!)
  2. 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

Installation Steps

  1. Check if Python is installed:
    python --version # or try: python3 --version
    You should see something like "Python 3.9.7" or newer.
  2. Download this project:
    • Download the ZIP file and extract it, OR
    • Use git clone if you know Git
  3. Open Terminal/Command Prompt:
    • Mac: Press Cmd+Space, type "Terminal"
    • Windows: Press Win+R, type "cmd"
  4. Navigate to the project folder:
    cd /path/to/futurama-quote-machine-mcp
  5. Create a virtual environment:
    # Mac/Linux: python3 -m venv venv source venv/bin/activate # Windows: python -m venv venv venv\Scripts\activate
  6. Install required packages:
    pip install mcp httpx
  7. Make the script executable (Mac/Linux only):
    chmod +x run_server.sh
  8. Test the server:
    # Mac/Linux: ./run_server.sh # Windows: run_server.bat
    If it works, you'll see no errors and it will wait for connections.
  9. 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": {} } } }
  10. 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"

  1. Check the path in your config file - Make sure it points to where you actually put the project
  2. Restart Claude Desktop after any config changes
  3. Test the server manually by running ./run_server.sh in Terminal

"Python not found" errors

  1. Install Python from python.org
  2. Make sure it's in your PATH - try python3 instead of python

"Permission denied" (Mac/Linux)

chmod +x run_server.sh

"Module not found" errors

Make sure you activated the virtual environment and installed the packages:

source venv/bin/activate # Mac/Linux # or venv\Scripts\activate # Windows pip install mcp httpx

Still having issues?

  1. Check the Claude Desktop logs - Look for error messages when the server starts
  2. Test the API directly - Visit https://fqm.jeremyschroeder.net/api/ in your browser
  3. 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:

  1. Edit server.py
  2. 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

futurama-quote-machine-mcp/ ├── server.py # Main MCP server code ├── run_server.sh # Startup script (Mac/Linux) ├── run_server.bat # Startup script (Windows) ├── requirements.txt # Python dependencies ├── claude_desktop_config.json # Example Claude Desktop config ├── README.md # This file └── LICENSE # MIT License

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 quote
  • GET /{id} - Get specific quote by ID
  • POST /quotes - Create new quote
  • PUT /{id} - Update existing quote
  • DELETE /{id} - Delete quote
  • GET /characters - List all characters

For full API documentation, visit: https://fqm.jeremyschroeder.net/api/

Contributing

Want to help improve this project?

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Test thoroughly
  5. 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.

Support

Made with ❤️ for the Futurama and Claude communities!

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

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.

  1. What This Does
    1. Quick Start (5 Minutes)
      1. Step 1: Download This Project
      2. Step 2: Set Up Python
      3. Step 3: Configure Claude Desktop
      4. Step 4: Update the Configuration
      5. Step 5: Start Using It!
    2. Detailed Installation Guide
      1. Prerequisites
      2. Installation Steps
    3. Usage Examples
      1. Getting Quotes
      2. Managing Quotes
      3. Exploring the Database
    4. Troubleshooting
      1. "Server not found" or "Connection failed"
      2. "Python not found" errors
      3. "Permission denied" (Mac/Linux)
      4. "Module not found" errors
      5. Still having issues?
    5. Customization
      1. Using a Different API
      2. Adding New Features
    6. File Structure
      1. API Reference
        1. Contributing
          1. Ideas for contributions:
        2. License
          1. Related Projects
            1. Support

              Related MCP Servers

              • mcp-server-cloudflareofficial

                cloudflare
                A
                security
                A
                license
                A
                quality
                Lets you use Claude Desktop, or any MCP Client, to use natural language to accomplish things on your Cloudflare account.
                Last updated -
                2
                1,453
                2,841
                TypeScript
                Apache 2.0
                • Apple

              • Things MCP Server

                hald
                A
                security
                A
                license
                A
                quality
                Enables interaction with the Things app through Claude Desktop, allowing task creation, project analysis, and priority management using natural language commands.
                Last updated -
                22
                104
                Python
                MIT License
                • Apple

              • Azure MCP Server

                kalivaraprasad-gonapa
                A
                security
                A
                license
                A
                quality
                Enables natural language interaction with Azure services through Claude Desktop, supporting resource management, subscription handling, and tenant selection with secure authentication.
                Last updated -
                9
                36
                15
                TypeScript
                MIT License

              • MCP Web Research Server

                jevy
                A
                security
                A
                license
                A
                quality
                A 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 -
                3
                859
                MIT License
                • Apple

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/BitsofJeremy/fqm_mcp_server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server