返回 MCP 目录
public公开dns本地运行

mealserver

一个基于Python的MCP服务器,用于访问TheMealDB API,提供食谱搜索、随机推荐、按分类/地区/食材查询等功能,支持AI助手通过自然语言交互获取烹饪信息。

article

README

🚀 Meal Server项目

Meal Server是一个提供食谱查询等功能的服务,用户可通过它查找各类食谱,同时提供了多种实用工具和资源。

🚀 快速开始

要开启Meal Server的使用之旅,请依照以下步骤完成安装:

  1. 下载最新版本的Meal Server安装包。
  2. 将下载的文件解压至您选定的目录。
  3. 打开终端或命令提示符,进入解压后的文件夹。
  4. 运行安装脚本:
    python setup.py install
    
  5. 安装完毕后,启动Meal Server服务:
    python server.py
    
  6. 打开浏览器,访问 http://localhost:8080 即可使用Meal Server。

✨ 主要特性

MCP工具

可用工具

  1. 显示 {cuisine} {category} 食谱:可查找符合特定菜系和类别的食谱。
    • 参数:
      • cuisine:菜系(例如,意大利、墨西哥)
      • category:类别(例如,主菜、甜点)
    • 示例:显示 Italian Pasta 食谱
  2. {category} 食谱推荐:能获取特定类别的所有食谱。
    • 参数:
      • category:类别(例如,海鲜、素食)
    • 示例:海鲜食谱推荐
  3. 寻找以 {letter} 开头的 {category} 食谱:可根据类别和首字母查找食谱。
    • 参数:
      • category:类别(例如,早餐、甜点)
      • letter:首字母(例如,A, B)
    • 示例:寻找以 B 开头的素食食谱
  4. 随机食谱推荐:可获取数据库中的随机食谱。
    • 示例:随机食谱推荐

资源

可用资源 URI

  1. 餐类分类http://localhost/meal_categories
    • 提供 14 种餐类的详细信息,包括名称、描述和缩略图 URL。
  2. 菜系区域http://localhost/cuisine_areas
    • 列出 29 个不同国家和地区的菜系。
  3. 常用食材http://localhost/common_ingredients
    • 提供超过 575 种常见烹饪食材的数据库,每种食材都有详细描述。

MCP提示

可用提示

  1. 显示 {cuisine} {category} 食谱:根据菜系和类别查找食谱。
    • 示例:显示 Italian Pasta 食谱
  2. {category} 食谱推荐:获取特定类别的所有食谱。
    • 示例:海鲜食谱推荐
  3. 寻找以 {letter} 开头的 {category} 食谱:根据类别和首字母查找食谱。
    • 示例:寻找以 B 开头的素食食谱
  4. 随机食谱推荐:获取随机食谱。
    • 示例:随机食谱推荐

💻 使用示例

基础用法

安装完成后,运行以下命令启动服务:

python server.py

然后在浏览器中访问 http://localhost:8080 即可使用MCP工具。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端