paprika-3-mcp

paprika-3-mcp

一个 Model Context Protocol (MCP) 服务，可将你的 Paprika 3 菜谱作为大模型可读取的资源提供出来，并让 Claude 之类的大模型在你的 Paprika 应用中创建或更新菜谱。

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

🚀 功能

发现缺少什么功能？欢迎在此仓库中提交 issue 申请！

📄 资源

• 菜谱 ✅
• 菜谱照片 🚧

🛠 工具

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

⚙️ 前提条件

• ✅ Mac、Linux 或 Windows 系统
• ✅ 已安装 Paprika 3 并启用云同步
• ✅ 你的 Paprika 3 用户名和密码
• ✅ 已启用 MCP 工具支持的 Claude 或其他大模型客户端

🛠 安装

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

🍎 macOS（通过 Homebrew）

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

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

🐧 Linux / 🪟 Windows

1. 前往最新版本。

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

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

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",
        "<your paprika 3 username (usually email)>",
        "--password",
        "<your paprika 3 password>"
      ]
    }
  }
}

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

📄 许可证

本项目依据 MIT License 开源，© 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 天后清除。