关键词

AI Agent开发Claude Code插件Gmail邮件导出AI图像生成大模型功能扩展

项目简介

Vibe Garden是一个专注于AI Agent设计模式、认知架构研究与开发的生态系统。它提供了两个核心的Model Context Protocol (MCP) 服务器插件：'Courier MCP'实现了Gmail邮件集成，而'Wyrd-Gen MCP'则提供了AI图像生成功能。这两个插件都以MCP服务器的形式运行，通过标准的JSON-RPC协议与LLM客户端（如Claude Code）通信，为LLM提供标准化的上下文信息和强大的工具调用能力。

主要功能点

  • Claude Code插件托管: 提供多个与Claude Code客户端无缝集成的后端服务。
  • Gmail邮件管理 (Courier MCP):
    • 通过自然语言查询Gmail邮件，支持完整的Gmail搜索语法。
    • 将邮件内容导出为结构化的Markdown文件，包含YAML元数据。
    • 支持并发邮件获取、速率限制处理和OAuth 2.0认证。
  • AI图像生成 (Wyrd-Gen MCP):
    • 通过Replicate API实现文本到图像的生成。
    • 支持Flux、Stable Diffusion等多种AI模型。
    • 提供模型参数发现功能，帮助用户了解不同模型的可用设置。
    • 具备文件冲突预防机制，避免覆盖现有文件。

安装步骤

  1. 克隆仓库: 将'vibe-garden'仓库克隆到您的本地机器： 
    git clone https://github.com/rjroy/vibe-garden.git
cd vibe-garden
  2. 设置Python环境: 确保您的系统安装了Python 3.8+。
    • 进入'courier-mcp/server'目录，安装其依赖： 
      cd courier-mcp/server
pip install -r requirements.txt # 假设存在requirements.txt文件
cd ../../
    • 进入'wyrd-gen-mcp/server'目录，安装其依赖： 
      cd wyrd-gen-mcp/server
pip install -r requirements.txt # 假设存在requirements.txt文件
cd ../../
  3. 配置Gmail认证 (Courier MCP):
    • 访问 Google Cloud Platform，创建一个OAuth 2.0客户端ID，选择“桌面应用”类型，然后下载'credentials.json'文件。
    • 将下载的'credentials.json'文件放置在'vibe-garden/courier-mcp/server/'目录下。
    • 设置环境变量'GMAIL_CREDENTIALS_PATH'，指向这个'credentials.json'文件的绝对路径。首次运行Courier MCP时，它会引导您完成OAuth认证流程，并在同一目录下生成一个'token.pickle'文件用于后续认证。
  4. 配置Replicate API Token (Wyrd-Gen MCP):
    • 注册 Replicate 账户并获取您的API Token。
    • 设置环境变量'REPLICATE_API_TOKEN'为您的Replicate API密钥。
  5. 在Claude Code中安装插件:
    • 在Claude Code环境中，使用'/plugin install <plugin-name>@vibe-garden'命令安装所需的插件。例如：
      • 安装Gmail集成插件：'/plugin install courier-mcp@vibe-garden'
      • 安装AI图像生成插件：'/plugin install wyrd-gen-mcp@vibe-garden'

服务器配置 (MCP客户端使用)

MCP客户端（如Claude Code）通过以下JSON配置信息连接到这两个MCP服务器。您需要将这些配置添加到您的MCP客户端配置文件中。

[
  {
    "name": "courier-mcp",
    "command": "python",
    "args": ["-m", "courier_mcp"]
    // 这是启动Courier MCP服务器的Python模块命令。
    // 客户端在启动此服务器时，会执行 'python -m courier_mcp'。
    // 请确保在服务器运行环境中，Python及其相关依赖已正确安装，
    // 并且已设置好GMAIL_CREDENTIALS_PATH环境变量指向Google OAuth凭据文件。
  },
  {
    "name": "wyrd-gen-mcp",
    "command": "python",
    "args": ["-m", "wyrd_gen_mcp"]
    // 这是启动Wyrd-Gen MCP服务器的Python模块命令。
    // 客户端在启动此服务器时，会执行 'python -m wyrd_gen_mcp'。
    // 请确保在服务器运行环境中，Python及其相关依赖已正确安装，
    // 并且已设置好REPLICATE_API_TOKEN环境变量指向您的Replicate API密钥。
  }
]

基本使用方法

安装并配置好插件后，您可以在Claude Code中直接通过自然语言与这些工具进行交互：

  • 使用Courier MCP导出Gmail邮件: 'You: Export my last 10 unread emails to ~/notes/emails' Claude: [使用'courier-mcp'导出邮件] ✓ Exported 10 messages in 3.2 seconds

  • 使用Wyrd-Gen MCP生成图像: 'You: Generate an image of a serene mountain landscape at sunset' Claude: [使用'wyrd-gen-mcp'通过Replicate生成图像] ✓ Image saved to: ./mountain-sunset.png

信息

分类

AI与计算

访问项目