Beefree SDK MCP Example Demo

使用AI代理创建电子邮件| Beefree SDK+PydanticAI MCP展示

你在探索代理电子邮件设计吗？我们认为，内容设计的未来意味着让人工智能代理和人类无缝协作来创建内容——这个简单的演示应用程序向您展示了如何创建一个这样的设计体验。

它连接了 Beefree SDK （市场上最直观的拖放式电子邮件编辑器） Pydanticai代理 使用模型上下文协议（MCP），并支持Anthropic、OpenAI和Gemini作为LLM提供者。

以下是您可以实现的目标：

• 基于人工智能的电子邮件设计：使用自然语言创建和修改电子邮件模板
• 所见即所得编辑器：允许人类在Beefree SDK提供的直观拖放编辑器中轻松编辑人工智能创建的草稿

是什么推动了这种体验：

• 实时流媒体： 基于WebSocket的流媒体聊天接口
• MCP集成： 直接连接到Beefree的Streamble HTTP MCP服务器。
• 现代工具：内置uv，实现快速依赖管理

先决条件

• Python 3.13+
• 紫外线 用于包管理（推荐）
• Beefree SDK帐户（如果您已经有帐户，可以 在此处获取您的凭据如果你是Beefree SDK的新手，你可以 注册一个免费帐户.)
• Anthropic、OpenAI或Gemini API密钥
• Beta访问。了解如何在我们的 Beefree SDK MCP服务器（测试版）文档.

快速开始

1.克隆并安装

# Clone the repository
git clone 
cd beefree_mcp_example

# Install with uv
uv sync

2.配置环境

创建 .env 归档并添加您的凭据。选择与您的提供商匹配的示例。 人类学：

AI_PROVIDER=anthropic
BEEFREE_CLIENT_ID=your_beefree_client_id
BEEFREE_CLIENT_SECRET=your_beefree_client_secret
BEEFREE_MCP_API_KEY=your_beefree_mcp_api_key
ANTHROPIC_API_KEY=your_anthropic_api_key
LLM_MODEL=claude-opus-4-5

OpenAI：

AI_PROVIDER=openai
BEEFREE_CLIENT_ID=your_beefree_client_id
BEEFREE_CLIENT_SECRET=your_beefree_client_secret
BEEFREE_MCP_API_KEY=your_beefree_mcp_api_key
OPENAI_API_KEY=your_openai_api_key
LLM_MODEL=gpt-5.2

双子座：

AI_PROVIDER=gemini
BEEFREE_CLIENT_ID=your_beefree_client_id
BEEFREE_CLIENT_SECRET=your_beefree_client_secret
BEEFREE_MCP_API_KEY=your_beefree_mcp_api_key
GEMINI_API_KEY=your_gemini_api_key
LLM_MODEL=gemini-2.5-pro

3.运行应用程序

# With uv
uv run python main.py

该应用程序将在 http://localhost:8000

运作原理

1. 用户输入：用户在聊天界面中键入自然语言请求。
2. 代理运行PydanticAI代理使用对话历史和编辑器上下文运行。
3. MCP执行：直接通过HTTP调用Beefree的MCP服务器修改电子邮件模板。
4. 进度更新：UI显示分步进度消息。
5. 编辑器集成：更改会反映在Beefree编辑器中。

资源

关于Beefree SDK

• Beefree SDK文档
• Beefree SDK MCP服务器文档

关于PydanticAI：

• PydanticAI文档
• PydanticAI MCP集成

更多资源：

• 此演示的MCP工具列表： mcp-tool-list.md
• 什么是a 模型上下文协议?
• 紫外线文件