paprika-3-mcp

一个 模型上下文协议 (MCP) 服务器，它将你的 Paprika 3 食谱作为 LLM 可读的资源公开 — 并且允许像 Claude 这样的 LLM 在你的 Paprika 应用中创建或更新食谱。

🖼️ 示例：Claude 使用 Paprika MCP 服务器

<p align="center"> <img src="docs/example.png" alt="MCP server running with Claude" /> </p>

🚀 功能

发现有任何缺失的功能吗？ 在此仓库上打开一个 issue 来请求功能！

📄 资源

• 食谱 ✅
• 食谱照片 🚧

🛠 工具

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

⚙️ 前提条件

• ✅ Mac、Linux 或 Windows 系统
• ✅ 安装了 Paprika 3 并启用了云同步
• ✅ 你的 Paprika 3 用户名和密码
• ✅ 启用了 MCP 工具支持 的 Claude 或任何 LLM 客户端

🛠 安装

你可以从 Releases 页面下载预构建的二进制文件。

🍎 macOS (通过 Homebrew)

如果你使用的是 macOS，最简单的安装方式是使用 Homebrew：

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

🐧 Linux / 🪟 Windows

1. 前往 最新版本。

2. 下载适合你的操作系统和架构的压缩包：

   • paprika-3-mcp_<version>_linux_amd64.zip for Linux
   • paprika-3-mcp_<version>_windows_amd64.zip for Windows

3. 解压 zip 压缩包：

   • Linux:

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

   • Windows:
     • 右键单击 .zip 文件并选择 全部提取，或使用 7-Zip 等工具。

4. 将二进制文件移动到系统 $PATH 中的目录：

   • Linux:

     sudo mv paprika-3-mcp /usr/local/bin/
     

   • Windows:

     • 将 paprika-3-mcp.exe 移动到 PATH 中的任何文件夹（例如，%USERPROFILE%\bin）

✅ 测试安装

你可以通过检查来验证服务器是否已安装：

paprika-3-mcp --version

你应该看到：

paprika-3-mcp version v0.1.0

🤖 设置 Claude

如果你之前没有设置过 MCP，首先阅读更多关于如何安装 Claude Desktop 客户端并配置 MCP 服务器的信息。

要将 paprika-3-mcp 添加到 Claude，你只需在 claude_desktop_config.json 文件的 mcpServers 部分中创建另一个条目：

{
  "mcpServers": {
    "paprika-3": {
      "command": "paprika-3-mcp",
      "args": [
        "--username",
        "<你的 Paprika 3 用户名（通常是电子邮件）>",
        "--password",
        "<你的 Paprika 3 密码>"
      ]
    }
  }
}

重启 Claude，你应该在点击锤头图标后看到 MCP 服务器工具：

📄 许可证

本项目在 MIT 许可证 下开源 © 2025 Lucas Stephens。

---

🗂 杂项

📄 我在哪里可以查看服务器日志？

MCP 服务器使用 Go 的 slog 编写结构化日志，并通过 lumberjack 进行轮换。 日志文件会根据你的操作系统自动创建：

操作系统	日志文件路径
macOS	~/Library/Logs/paprika-3-mcp/server.log
Linux	/var/log/paprika-3-mcp/server.log
Windows	%APPDATA%\paprika-3-mcp\server.log
其他 / 未知	/tmp/paprika-3-mcp/server.log

💡 日志在 100MB 时自动轮换，仅保留 5 个备份文件。 日志也会在 10 天后清除。