MCP Email Service

# 📥 MCP 邮箱浏览客户端 这个子项目提供了一个简单的命令行客户端，可以直接读取主项目中的 MCP 邮件服务，聚合查看全部邮箱账户的邮件。 ## 目录结构 ``` clients/ └── mailbox_client/ ├── README.md # 本说明文件 ├── __init__.py # 包初始化 ├── __main__.py # 允许 python -m clients.mailbox_client 运行 ├── client.py # 复用主项目服务层的封装 └── cli.py # 命令行实现 ``` ## 快速开始 > 运行前请确保已经通过 `python setup.py` 配置好了邮箱账户，并完成过至少一次同步。 ### 🎯 交互式模式（推荐新手） 最简单的使用方式，类似 `setup.py` 的菜单界面： ```bash # 启动交互式模式 uv run python -m clients.mailbox_client # 或者显式指定交互式模式 uv run python -m clients.mailbox_client interactive ``` 交互式模式提供友好的菜单界面，无需记忆命令参数。 ### 📋 命令行模式（适合脚本） ```bash # 列出所有账户 uv run python -m clients.mailbox_client list-accounts # 查看最近 20 封邮件（默认聚合全部账户） uv run python -m clients.mailbox_client list-emails --limit 20 # 查看未读邮件 uv run python -m clients.mailbox_client list-emails --unread-only # 查看指定账户的邮件 uv run python -m clients.mailbox_client list-emails --account-id my_account_id # 查看单封邮件详情（需要提供账户 ID） uv run python -m clients.mailbox_client show-email 123456 --account-id my_account_id ``` 所有命令都支持 `--json` 参数，以 JSON 方式输出原始数据，方便与其他工具集成。 ## 功能特性 - ✅ 聚合浏览多个邮箱的收件箱 - ✅ 支持中文终端输出 & JSON 输出 - ✅ 可快速查看单封邮件详情（主题、正文、附件等） - ✅ 不与主项目代码混合：全部逻辑位于 `clients/mailbox_client/` 子目录 如需定制更复杂的展示界面，可以直接基于 `client.py` 中的 `MailboxClient` 类进行二次开发。