MCP 服务器

meals-mcp-server

Connects Claude AI to a live meals database, enabling natural language queries for meal search by name, ingredient, or ID, and random meal suggestions.

README

🍽️ meals-mcp-server

A Model Context Protocol (MCP) server that connects Claude AI to a live meals database. Ask Claude anything about meals — search by name, ingredient, or ID, or get a random meal suggestion — all through natural language.

📁 Project Structure

meals-mcp-server/
│
├── meals_server.py        # MCP server — all tools defined here
├── requirements.txt       # Python dependencies
├── README.md
└── screenshots/
    ├── mcp_server.png
    ├── claude_connect.png
    ├── meal_by_name.png
    ├── meal_by_ingredient.png
    ├── meal_by_id.png
    └── random_meal.png

⚙️ Setup & Installation

1. Clone the repo

git clone https://github.com/YOUR-USERNAME/meals-mcp-server.git
cd meals-mcp-server

2. Create a virtual environment

python -m venv venv
source venv/bin/activate        # Mac/Linux
venv\Scripts\activate           # Windows

3. Install dependencies

pip install -r requirements.txt

4. Run the server

python meals_server.py

🔌 Connect to Claude Desktop

Open Claude Desktop → Settings → Developer
Click Edit Config to open claude_desktop_config.json
Add the following (replace the path with your actual path):

{
  "mcpServers": {
    "meals": {
      "command": "/Users/spartan/Desktop/DATA 236 (Distributed)/Homework/HW 5/part 2/venv/bin/python",
      "args": [
        "/Users/spartan/Desktop/DATA 236 (Distributed)/Homework/HW 5/part 2/meals_server.py"
      ]
    }
  },
  "preferences": {
    "coworkWebSearchEnabled": true,
    "sidebarMode": "chat",
    "coworkScheduledTasksEnabled": false
  }
}

Restart Claude Desktop
The meals tools will appear in Claude's tool panel ✅

🧰 Available Tools

Tool	Description
`meal_by_name`	Search for meals by name
`meal_by_ingredient`	Find meals containing a specific ingredient
`meal_by_id`	Get full details of a meal by its ID
`random_meal`	Fetch a random meal suggestion