MailPilot--AI Powered Email Assisstant

📬 MailPilot

AI驱动的电子邮件助手，允许您使用Gemini API和MCP（模型上下文协议）发送常规电子邮件或AI生成的电子邮件。

✨ 特性

• 常规电子邮件：使用MCP直接通过Gmail发送电子邮件
• AI电子邮件生成：键入提示，让Gemini AI制作专业电子邮件
• 现代用户界面：使用Tailwind CSS的简洁、响应式界面
• 服务器操作：使用Next.js 14进行安全的服务器端电子邮件处理+

🚀 技术栈

• Next.js 14 （应用路由器）
• 反应18
• 顺风 CSS
• MCP（模型上下文协议） 用于Gmail集成
• 双子星AI API 用于电子邮件生成
• 阿西奥斯 用于API请求

📋 先决条件

1. Node.js （v18或更高版本）
2. Gemini API密钥 -从以下地址获取 谷歌人工智能工作室
3. Gmail帐户 连接到Zapier MCP
4. Zapier MCP服务器 配置

🛠️ 设置

1.安装依赖项

npm install

2.配置环境变量

创建一个 .env.local 项目根目录中的文件：

GEMINI_API_KEY=your_gemini_api_key_here
ZAPIER_MCP_URL=your_zapier_mcp_url_here

获取钥匙：

• GEMINI_API_键：从 谷歌人工智能工作室
• ZAPIER_MCP_URL：从 Zapier MCP 连接Gmail后

3.设置MCP Gmail连接

确保Zapier MCP服务器配置了Gmail访问权限。检查你的 ~/.cursor/mcp.json 或等效的配置文件。

4.运行开发服务器

npm run dev

打开 http://localhost:3000 在您的浏览器中。

📁 项目结构

mailpilot/
├── app/
│   ├── actions/
│   │   ├── sendEmail.js       # Regular email sender
│   │   └── sendAIEmail.js     # AI email generator & sender
│   ├── page.jsx               # Main page
│   ├── layout.jsx             # Root layout
│   └── globals.css            # Global styles
├── components/
│   ├── EmailForm.jsx          # Regular email form
│   └── AIEmailForm.jsx        # AI email form
├── mcp-client.js              # MCP client configuration
├── package.json
├── tailwind.config.js
├── postcss.config.js
└── next.config.js

🎯 用法

发送常规电子邮件

1. 填写收件人电子邮件、主题和正文
2. 点击“发送电子邮件”
3. 电子邮件将通过MCP通过Gmail发送

生成并发送AI电子邮件

1. 输入收件人电子邮件和主题
2. 键入一个提示，描述您希望电子邮件说什么

- 示例：“写一封后续电子邮件，感谢他们的会面”

1. 点击“生成并发送AI电子邮件”
2. Gemini AI将生成电子邮件内容并自动发送

🔧 配置

MCP客户端

MCP客户端已在中配置 mcp-client.js 连接到Zapier的Gmail集成。确保您的MCP服务器正在运行：

npx @modelcontextprotocol/cli run src/index.ts

API双子星

该项目使用Gemini Pro模型进行文本生成。您可以在中修改模型或提示 app/actions/sendAIEmail.js.

📝 API 参考

Gemini API终点

POST https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent

MCP Gmail工具

client.callTool("mcp_Zapier_gmail_send_email", {
  instructions: "...",
  to: ["email@example.com"],
  subject: "...",
  body: "...",
  body_type: "html"
});

🚀 生产部署

准备好部署到生产环境了吗？查看我们的综合 生产部署指南 有关部署到Vercel的详细说明。

快速部署到Vercel

1. 将代码推送到Git （GitHub、GitLab或Bitbucket）

1. 导入到Vercel

- 访问 vercel.com/new - 导入您的存储库 - 框架：Next.js（自动检测）

1. 添加环境变量

   GEMINI_API_KEY=your_actual_gemini_api_key
   ZAPIER_MCP_URL=your_actual_zapier_mcp_url

1. 部署

- 单击部署并等待2-3分钟 - 您的应用程序将在 https://your-project.vercel.app

有关详细说明、故障排除和最佳实践，请参阅 产量_产量.md.

🐛 故障排除

电子邮件未发送

• 验证您的MCP服务器是否正在运行（仅限开发）
• 检查Zapier中的Gmail是否已正确连接
• 确保您具有正确的身份验证
• 验证 ZAPIER_MCP_URL 环境变量设置正确

AI生成失败

• 验证 GEMINI_API_KEY 设置正确
• 检查您是否有可用的API配额
• 查看Gemini API控制台是否存在错误

构建错误

# Clear Next.js cache
rm -rf .next
npm run dev

环境变量未加载

• 确保 .env.local 存在于项目根目录中
• 添加新变量后重新启动开发服务器
• 检查变量名中的拼写错误

🤝 贡献

请随时提交问题和增强请求！

📄 许可证

麻省理工学院许可证-您可以自由使用此项目进行学习和生产。

🔗 链接

• Gemini API文件
• 模型上下文协议（MCP）
• Next.js文档
• Zapier MCP服务器

______________________________________________________________________

由以下材料制成❤️ 使用MCP和Gemini AI