Famous Film Dialogues MCP Server\n\n## Overview\n\nThe famous-film-dialogues MCP server fetches iconic and memorable film quotes from both classic and modern movies. It exposes a simple MCP API tool that retrieves a random famous movie quote, including details such as the movie title, the character, and the actor when available.\n\n## Features\n- Retrieve random, well-known film quotes via the Model Context Protocol (MCP).\n- Includes film title, character, and (if available) the actor who delivered the quote.\n- Runs as an MCP stdio server, suitable for integration into toolchains, bots, or creative projects.\n\n## Installation\n\n### Prerequisites\n- Node.js (version 16 or newer)\n- npm\n\n### Steps\n\n1. Clone this repository or download the files.\n\n2. Install dependencies:\n\n npm install\n\n3. (Optional) To install globally as a CLI tool:\n\n npm install -g .\n\n## Usage\n\n### Starting the Server\n\nTo run the MCP server using stdio transport:\n\n npm start\n\nOr if installed globally (as CLI):\n\n famous-film-dialogues\n\nThe server listens on stdio for MCP-compatible requests.\n\n### Example Tool Calls\n\nYou can call the provided tool as follows (input/output shown for demonstration):\n\nTool Name: get_random_film_quote\n\nInput:\n\n {}\n\nOutput (example):\n\n {\n "success": true,\n "data": {\n "quote": "Here's looking at you, kid.",\n "movie": "Casablanca",

    "character": "Rick Blaine",
    "actor": "Humphrey Bogart"
  },
  "error": null
}

If an error occurs (e.g., network failure), an error message will be returned:

{
  "success": false,
  "data": null,
  "error": "Failed to fetch quote: <error message>"
}

Configuration

No configuration is required. The server is ready to use out-of-the-box.

License

MIT License