鸡尾酒API服务

一个通过Api Ninjas API访问鸡尾酒信息的MCP服务器,提供鸡尾酒名称和成分搜索功能。

  • by BACH-AI-Tools
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 BACH-AI-Tools/cocktail_by_api_ninjas

使用说明

Cocktail By Api Ninjas MCP Server

English |Simplified Chinese| Traditional Chinese

MCP server used to access Cocktail By API Ninjas API.

🚀 Quickly experience using the EMCP platform

EMCP It is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!

Quick Start:

  1. 🌐 visit EMCP platform
  2. 📝 Register and log in to your account
  3. 🎯 enter MCP SquareBrowse all available MCP servers
  4. 🔍 Search or find this server(bach-cocktail_by_api_ninjas)
  5. 🎉 click Install MCP button
  6. ✅ Done! Can be used in your application

Advantages of the EMCP platform:

  • ✨ Zero configurationNo need to manually edit configuration files
  • 🎨 Visual managementEasily manage all MCP servers through a graphical interface
  • 🔐 safe and reliableUnified management of API keys and authentication information
  • 🚀 One-click installationMCP Square offers a wide range of server options
  • 📊 Use statisticsReal time viewing of service invocation status

Visit Now EMCP platform Start your MCP journey!


Introduction

This is an MCP server used to access the Cocktail By Api Ninjas API.

  • PyPI package name: bach-cocktail_by_api_ninjas
  • version: 1.0.0
  • transmission protocol: stdio

install

Install from PyPI:

pip install bach-cocktail_by_api_ninjas

Install from source code:

pip install -e .

run

Method 1: Use UVX (recommended, no installation required)

# 运行(uvx 会自动安装并运行)
uvx --from bach-cocktail_by_api_ninjas bach_cocktail_by_api_ninjas

# 或指定版本
uvx --from bach-cocktail_by_api_ninjas@latest bach_cocktail_by_api_ninjas

Method 2: Direct Run (Development Mode)

python server.py

Method 3: Run as a command after installation

# 安装
pip install bach-cocktail_by_api_ninjas

# 运行(命令名使用下划线)
bach_cocktail_by_api_ninjas

configuration

API certification

This API requires authentication. Please set environment variables:

export API_KEY="your_api_key_here"

environment variable

Variable Name Description Required
API_KEY API Key Yes
PORT Not applicable No
HOST Not applicable No

Use in cursor

Edit cursor MCP configuration file ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bach-cocktail_by_api_ninjas": {
      "command": "uvx",
      "args": ["--from", "bach-cocktail_by_api_ninjas", "bach_cocktail_by_api_ninjas"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Using Claude Desktop

Edit Claude Desktop configuration file claude_desktop_config.json:

{
  "mcpServers": {
    "bach-cocktail_by_api_ninjas": {
      "command": "uvx",
      "args": ["--from", "bach-cocktail_by_api_ninjas", "bach_cocktail_by_api_ninjas"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

This server provides the following tools:

v1cocktail

API Ninjas Cocktail API endpoint. Either name or ingredients parameter must be set.

endpoint: GET /v1/cocktail

parameter:

  • name (string): name of cocktail. This parameter supports partial matches (e.g. bloody will match bloody mary and bloody margarita)

  • ingredients (string): comma-separated string of ingredients to search. Only cocktails containing all listed ingredients will be returned. For example, to search cocktails containing Vodka and lemon juice, use vodka,lemon juice.


tech stack

  • transmission protocol: stdio
  • HTTP client: httpx

license

MIT License - see details LICENSE Document.

development

This server is composed of API-to-MCP Tool generation.

Version: 1.0.0