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

cookbook-mcp-server

一个基于MCP协议的菜谱查询服务,支持获取所有菜品列表和具体菜谱信息。

article

README

🚀 菜谱 MCP 服务器

菜谱 MCP 服务器是一个提供菜品菜谱相关服务的平台。它支持获取菜谱集中的所有菜谱,还能获取任意菜品的具体菜谱,为用户提供便捷的菜谱查询功能。

🚀 快速开始

✨ 主要特性

  • get_all_dishes:可获取菜谱集中的所有菜谱。
  • get_recipe:能够获取任意菜品的菜谱。

📦 安装指南

# 创建一个新的项目目录
uv init cookbook
cd cookbook

# 创建虚拟环境并激活它
uv venv
source .venv/bin/activate

# 安装依赖项
uv add "mcp[cli]"

💻 使用示例

基础用法

  1. 获取菜谱: 菜谱源:https://github.com/Anduin2017/HowToCook/tree/master
git clone https://github.com/Anduin2017/HowToCook/tree/master
  1. 替换 cookbook.py 中的菜谱集路径:将上文中克隆下来的仓库的 dishes 文件夹路径填入下面常量。
# 常量
COOKBOOK_URL = "/YOUR/COOKBOOK/PATH"
  1. 配置 mcp 客户端
{
  "mcpServers": {
    "cookbook": {
      "command": "/YOUR/UV/PATH",
      "args": [
        "--directory",
        "/YOUR/ROOT/mcp-server-cookbook/cookbook",
        "run",
        "/YOUR/ROOT/mcp-server-cookbook/cookbook.py"
      ]
    }
  }
}

高级用法

如果使用 sse 服务器,需要进行以下修改:

  • 修改 cookbook.py 中的执行入口
if __name__ == "__main__":
    # 初始化并运行服务器
    mcp.run(transport='sse')
  • 修改 mcp 客户端配置:注意端口号。
{
  "mcpServers": {
    "cookbook": {
      "url": "http://localhost:PORT/sse"
    }
  }
}

📚 详细文档

使用效果截图

img.png img.png

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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