Paprika 3 MCP

🚀 paprika-3-mcp

本项目是一个 模型上下文协议 (MCP) 服务器，它能将 Paprika 3 食谱转化为大语言模型（LLM）可读的资源。借助该服务器，像 Claude 这样的大语言模型可以创建或更新您 Paprika 应用中的食谱。

🚀 快速开始

本项目旨在提供一个便捷的方式，让大语言模型与 Paprika 3 食谱进行交互。通过搭建此服务器，您可以利用大语言模型的能力来管理您的食谱。

✨ 主要特性

若您发现有任何缺失的功能，可在此仓库中发起问题请求新功能！

📄 资源

• 食谱 ✅
• 食谱照片 🚧

🛠 工具

• create_paprika_recipe：允许 Claude 将新食谱保存到您的 Paprika 应用中。
• update_paprika_recipe：允许 Claude 修改现有食谱。

⚙️ 先决条件

• ✅ 支持 Mac、Linux 或 Windows 系统。
• ✅ 需安装 Paprika 3 并启用云同步功能。
• ✅ 您需要准备好 Paprika 3 的 用户名和密码。
• ✅ 需使用带有 MCP 工具支持 的大语言模型，例如 Claude。

📦 安装指南

您可在 发布页面 下载预构建的二进制文件。

🍎 macOS（通过 Homebrew）

若您使用 macOS 系统，可通过 Homebrew 轻松完成安装：

brew tap soggycactus/tap
brew install paprika-3-mcp

🐧 Linux / 🪟 Windows

1. 访问 最新版本。
2. 下载适合您操作系统和架构的存档文件：
   • paprika-3-mcp_<version>_linux_amd64.zip 适用于 Linux 系统。
   • paprika-3-mcp_<version>_windows_amd64.zip 适用于 Windows 系统。
3. 解压 zip 存档：
   • Linux：

     unzip paprika-3-mcp_<version>_<os>_<arch>.zip
     

   • Windows：右键点击 .zip 文件，选择“在此处解压”。
4. 安装完成后，请将 paprika-3-mcp 添加到您的系统路径中。

💻 使用示例

基础用法

启动服务器

要启动 MCP 服务器，请运行以下命令：

paprika-3-mcp serve --port 12345

在 Claude 中使用

在 Claude 中，您可以按如下方式调用此服务器：

from paprika_mcp_client import PaprikaMCPClient

client = PaprikaMCPClient('localhost', 12345)
# 创建新食谱
client.create_paprika_recipe(recipe_data)
# 更新现有食谱
client.update_paprika_recipe(recipe_id, recipe_update)

高级用法

以下是在 Claude 中使用的示例 JSON 命令：

{
  "command": "create_paprika_recipe",
  "args": {
    "title": "新食谱",
    "ingredients": ["200g 面粉", "100ml 牛奶"],
    "instructions": [
      "将面粉和牛奶混合。",
      "加热至沸腾。"
    ]
  }
}

💡 使用建议

• MCP 服务器支持以下命令：create_paprika_recipe、update_paprika_recipe 和 list_paprika_recipes。
• 服务器默认监听端口为 12345，如需更改，请在启动时指定 --port 参数。

📋 日志

日志路径

💡 日志文件根据运行环境存储位置如下：

• macOS/Linux：/tmp/paprika-3-mcp/server.log
• Windows：%TEMP%\paprika-3-mcp\server.log
• 非上述系统：/tmp/paprika-3-mcp/server.log

日志管理

💡 日志文件大小限制为 100MB，最多保留 5 个备份文件，并且超过 10 天的日志文件将被自动清理。

📄 许可证

项目遵循 MIT License 协议。版权所有 © 2024 您的姓名或公司名称。保留所有权利。