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 您的姓名或公司名稱。保留所有權利。