AI导哈

AI邮件助手

MailPilot是一款AI驱动的邮件助手，支持通过Gemini API和MCP协议发送常规邮件或AI生成的邮件。

  • by Mahad-007
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 Mahad-007/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

获取钥匙：

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. 键入一个提示，描述您希望电子邮件说什么
    • 示例：“写一封后续电子邮件，感谢他们的会面”
  3. 点击“生成并发送AI电子邮件”
  4. 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）

  2. 导入到Vercel

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

  3. 添加环境变量

    GEMINI_API_KEY=your_actual_gemini_api_key
ZAPIER_MCP_URL=your_actual_zapier_mcp_url

  4. 部署

    • 单击部署并等待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 存在于项目根目录中
  • 添加新变量后重新启动开发服务器
  • 检查变量名中的拼写错误

🤝 贡献

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

📄 许可证

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

🔗 链接

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

相关 MCP