{"_id":"@dennisk2025/random-cocktail-finder","name":"@dennisk2025/random-cocktail-finder","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-cocktail-finder","version":"1.0.0","description":"Fetches a random cocktail recipe, including name, instructions, ingredients, and an image for mixology inspiration.","type":"module","main":"index.js","bin":{"random-cocktail-finder":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-cocktail-finder@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-fV9zf13GLin2m+GrQyDiQhpmH4Sr+kAAcRL7YXy5zZX7l8Mxn2hTk8KcUni+HZnXc2teuCsIMzR0yC0w3L/EsA==","shasum":"3c7b2b40e26ce265d7bab340c091f0cdce8d7453","tarball":"https://registry.npmjs.org/@dennisk2025/random-cocktail-finder/-/random-cocktail-finder-1.0.0.tgz","fileCount":3,"unpackedSize":6170,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCLEYb5XjHwVJkFEYGp1QVMWBHkyTamGLhhLRv2WiDDfQIgGD+WHZT568FCYMJWaW4qEj24ZHteqy1PVWybb/cLNhY="}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/random-cocktail-finder_1.0.0_1761425454972_0.22393483733243813"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T20:50:54.886Z","1.0.0":"2025-10-25T20:50:55.147Z","modified":"2025-10-25T20:50:55.411Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches a random cocktail recipe, including name, instructions, ingredients, and an image for mixology inspiration.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# Random Cocktail Finder MCP Server\n\nFetches a random cocktail recipe, including its name, ingredients, instructions, and an image for mixology inspiration. Designed for integration with Claude Desktop using the Model Context Protocol (MCP).\n\n## Installation\n\nYou can use via npm or npx:\n\n- **npm install (recommended for local use):**\n  npm install @dennisk2025/random-cocktail-finder\n\n- **npx (zero-install):**\n  npx @dennisk2025/random-cocktail-finder\n\n## Adding to Claude Desktop\n\nTo add this MCP server to Claude Desktop, insert the following into your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"random-cocktail-finder\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-cocktail-finder\"]\n    }\n  }\n}\n```\n\n**Add this to your Claude Desktop config file at:**\n- `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)\n- `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows)\n\n## Usage\n\nOnce the server is running, it provides one tool:\n\n### Tool: `get_random_cocktail`\n\n- **Description:** Returns the name, ingredients, instructions, and image for a randomly selected cocktail.\n- **Parameters:** none (expects an empty object)\n\n#### Example Tool Call\n\nRequest:\n```json\n{\n  \"tool\": \"get_random_cocktail\",\n  \"parameters\": {}\n}\n```\n\nResponse:\n```json\n{\n  \"name\": \"Margarita\",\n  \"instructions\": \"Rub the rim of the glass with the lime slice to make the salt stick to it. Take care to moisten only the outer rim and pour out the excess salt. Shake the other ingredients with ice, then carefully pour into the glass.\",\n  \"ingredients\": [\n    { \"ingredient\": \"Tequila\", \"measure\": \"1 1/2 oz \" },\n    { \"ingredient\": \"Triple sec\", \"measure\": \"1/2 oz \" },\n    { \"ingredient\": \"Lime juice\", \"measure\": \"1 oz \" },\n    { \"ingredient\": \"Salt\", \"measure\": null }\n  ],\n  \"image\": \"https://www.thecocktaildb.com/images/media/drink/5noda61589575158.jpg\"\n}\n```\n\n### Available Tools\n\n| Tool Name            | Description                                                                           | Parameters                 |\n|----------------------|---------------------------------------------------------------------------------------|----------------------------|\n| get_random_cocktail  | Returns the name, ingredients, instructions, and image for a randomly selected cocktail.| _(none)_                   |\n\nAll results are returned as structured JSON for direct consumption by chatbots, clients, or mixologist apps.\n\n---\n\nIf you encounter problems or have feature requests, open an issue on the package repository or contact the maintainer.\n","readmeFilename":"README.md","_rev":"1-2c4d78f1661b43755b3b4051418acce3"}