{"skill":{"slug":"mail-mcp","displayName":"Mail Mcp","summary":"自动安装并使用 mail-mcp 发送、搜索、管理邮箱邮件和文件夹，支持附件和多种邮件操作。","description":"# Mail MCP Skill\n\n帮助用户使用邮件 MCP 服务，自动检查和安装 mail-mcp。\n\n## 触发词\n\n- 发邮件\n- 收邮件\n- 查邮件\n- 邮箱\n- email\n- mail\n- SMTP\n- IMAP\n- 附件\n\n## 功能\n\n1. **自动安装**: 检查 mail-mcp 是否已安装，未安装则自动从 GitHub 安装\n2. **发送邮件**: 支持纯文本、HTML、附件\n3. **搜索邮件**: 按 folder、条件搜索邮件\n4. **管理文件夹**: 列出、创建、删除、重命名文件夹\n5. **邮件操作**: 标记已读/未读、星标、移动、复制、删除\n\n## 安装检查\n\n### 方式一：pip 安装（推荐）\n\n```bash\npip install git+https://github.com/AdJIa/mail-mcp-server.git\n```\n\n### 方式二：本地安装\n\n```bash\ngit clone https://github.com/AdJIa/mail-mcp-server.git\ncd mail-mcp-server\npip install -e .\n```\n\n### 验证安装\n\n```bash\nwhich mail-mcp\n# 应输出: /home/xxx/.local/bin/mail-mcp\n```\n\n## 配置\n\n### mcporter 配置\n\n在 `~/.mcporter/mcporter.json` 中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"mail-mcp\": {\n      \"command\": \"mail-mcp\",\n      \"env\": {\n        \"IMAP_HOST\": \"your-imap-server.com\",\n        \"IMAP_PORT\": \"993\",\n        \"EMAIL_USER\": \"your-email@example.com\",\n        \"EMAIL_PASSWORD\": \"your-password\",\n        \"IMAP_SSL\": \"true\",\n        \"SMTP_HOST\": \"your-smtp-server.com\",\n        \"SMTP_PORT\": \"465\",\n        \"SMTP_SSL\": \"true\"\n      }\n    }\n  }\n}\n```\n\n### 环境变量说明\n\n| 变量 | 说明 | 示例 |\n|------|------|------|\n| `IMAP_HOST` | IMAP 服务器地址 | `mail.qiye.aliyun.com` |\n| `IMAP_PORT` | IMAP 端口 | `993` |\n| `EMAIL_USER` | 邮箱账号 | `user@example.com` |\n| `EMAIL_PASSWORD` | 邮箱密码 | `password` |\n| `IMAP_SSL` | 启用 SSL | `true` |\n| `SMTP_HOST` | SMTP 服务器地址 | `smtp.qiye.aliyun.com` |\n| `SMTP_PORT` | SMTP 端口 | `465` |\n| `SMTP_SSL` | 启用 SSL | `true` |\n| `SMTP_STARTTLS` | 启用 STARTTLS (端口 587) | `false` |\n\n### 常见邮箱配置\n\n| 邮箱 | IMAP | SMTP | 备注 |\n|------|------|------|------|\n| Gmail | `imap.gmail.com:993` | `smtp.gmail.com:465` | 需要 App Password |\n| 阿里云企业邮箱 | `mail.qiye.aliyun.com:993` | `smtp.qiye.aliyun.com:465` | |\n| 腾讯企业邮箱 | `imap.exmail.qq.com:993` | `smtp.exmail.qq.com:465` | |\n| QQ邮箱 | `imap.qq.com:993` | `smtp.qq.com:465` | 需要授权码 |\n| Outlook | `outlook.office365.com:993` | `smtp.office365.com:587` | STARTTLS |\n\n## 使用示例\n\n### mcporter 调用\n\n```bash\n# 列出文件夹\nmcporter call mail-mcp.list_folders\n\n# 搜索邮件\nmcporter call mail-mcp.search_emails --args '{\"folder\": \"INBOX\", \"limit\": 10}'\n\n# 发送邮件\nmcporter call mail-mcp.send_email --args '{\n  \"to\": [\"recipient@example.com\"],\n  \"subject\": \"测试邮件\",\n  \"body_text\": \"这是邮件内容\"\n}'\n\n# 发送带附件的邮件\nmcporter call mail-mcp.send_email --args '{\n  \"to\": [\"recipient@example.com\"],\n  \"subject\": \"带附件的邮件\",\n  \"body_text\": \"请查收附件\",\n  \"attachments\": [{\n    \"filename\": \"report.pdf\",\n    \"content_type\": \"application/pdf\",\n    \"data_base64\": \"JVBERi0xLjQK...\"\n  }]\n}'\n```\n\n### 发送附件示例\n\n```python\nimport base64\n\n# 读取文件并编码\nwith open(\"report.pdf\", \"rb\") as f:\n    data_base64 = base64.b64encode(f.read()).decode()\n\n# 使用 data_base64 作为 attachments[].data_base64\n```\n\n## MCP 工具列表\n\n| 工具 | 功能 |\n|------|------|\n| `list_folders` | 列出所有文件夹 |\n| `create_folder` | 创建文件夹 |\n| `delete_folder` | 删除文件夹 |\n| `rename_folder` | 重命名文件夹 |\n| `search_emails` | 搜索邮件 |\n| `get_email` | 获取邮件详情 |\n| `mark_read` | 标记已读 |\n| `mark_unread` | 标记未读 |\n| `mark_flagged` | 添加星标 |\n| `unmark_flagged` | 移除星标 |\n| `move_email` | 移动邮件 |\n| `copy_email` | 复制邮件 |\n| `delete_email` | 删除邮件 |\n| `get_current_date` | 获取当前时间 |\n| `send_email` | 发送邮件 |\n| `send_reply` | 回复邮件 |\n| `send_forward` | 转发邮件 |\n\n## 错误处理\n\n所有工具返回结构化响应，错误格式：\n\n```json\n{\n  \"error\": \"错误描述\"\n}\n```\n\n## 注意事项\n\n1. Gmail 需要使用 [App Password](https://support.google.com/accounts/answer/185833)\n2. QQ邮箱需要在设置中开启 IMAP/SMTP 并获取授权码\n3. 附件通过 base64 编码传输\n4. 建议使用 SSL 加密连接\n\n## 项目地址\n\nhttps://github.com/AdJIa/mail-mcp-server","tags":{"latest":"0.1.0"},"stats":{"comments":0,"downloads":716,"installsAllTime":27,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1773491408151,"updatedAt":1779078138356},"latestVersion":{"version":"0.1.0","createdAt":1773491408151,"changelog":"Mail MCP Skill 0.1.0 — 首发版本\n\n- 支持自动检查并安装 mail-mcp 邮件服务\n- 实现邮件发送（文本、HTML、附件）、收件、邮件搜索和文件夹管理\n- 提供常见邮箱配置及详细环境变量说明\n- 支持邮件操作：标记状态、星标、移动、复制、删除等\n- 全面 CLI/接口调用示例与出错返回格式说明","license":"MIT-0"},"metadata":null,"owner":{"handle":"adjia","userId":"s17ft1058ydjqzzywspbm6pmds884r7a","displayName":"AdJIa","image":"https://avatars.githubusercontent.com/u/13943009?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089886134}}