📬 MailNet MCP 服务器

MailNet 服务器是一个统一的代理电子邮件编排服务器，适用于 模型上下文协议。它支持 Gmail 和 Outlook，并提供标准化元数据、安全凭证注入以及丰富的工具集，用于驱动代理的工作流程。它是为 MailNet 邮件代理 AI 提供动力的 MCP 服务器。

---

🚀 特性

• ✅ 统一的 Gmail + Outlook 抽象
• ✅ 自动令牌刷新和凭证卫生
• ✅ 标准化的基础类以扩展提供商
• ✅ 代理电子邮件设置端点（语气、签名、线程上下文等）
• ✅ 模块化工具集：发送、读取、搜索、标签、归档、回复、删除、草稿

---

🛠 安装

1. 手动克隆并启动

git clone https://github.com/Astroa7m/MailNet-MCP-Server.git
cd MailNet-MCP-Server

安装依赖项

pip install -r requirements.txt

注意：如果你打算使用 uv 启动，请首先通过以下方式安装它：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

启动

可以通过 uv 启动：

uv run -m mcp_launcher.server

或者

python -m mcp_launcher.server

---

🔒 环境变量

设置你的环境变量以获取提供商凭证：

Gmail

GOOGLE_CREDENTIALS_FILE_PATH=path/to/google_credentials.json
GOOGLE_PREFERRED_TOKEN_FILE_PATH=path/to/google_token.json

Outlook (Azure)

AZURE_APPLICATION_CLIENT_ID=your-client-id
AZURE_CLIENT_SECRET_VALUE=your-secret
AZURE_PREFERRED_TOKEN_FILE_PATH=path/to/azure_token.json

查看 Azure 授权指南 和 Google 授权指南，了解如何设置账户并准备好你的令牌/凭证。

---

🖥 Claude Desktop 集成

在你的 claude_desktop_config.json 中添加以下内容：

{
  "mcpservers": {
    "email_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\Path\\To\\mcp-server",
        "run",
        "-m",
        "mcp_launcher.server"
      ],
      "env": {
        "AZURE_APPLICATION_CLIENT_ID": "<AZURE_APPLICATION_CLIENT_ID>",
        "AZURE_CLIENT_SECRET_VALUE": "<AZURE_CLIENT_SECRET_VALUE>",
        "AZURE_PREFERRED_TOKEN_FILE_PATH": "C:\\Path\\To\\azure_token.json",
        "GOOGLE_CREDENTIALS_FILE_PATH": "C:\\Path\\To\\google_credentials.json",
        "GOOGLE_PREFERRED_TOKEN_FILE_PATH": "C:\\Path\\To\\google_token.json"
      }
    }
  }
}

---

🧠 代理电子邮件设置

你可以通过 load_email_settings 工具查看设置或通过 update_email_settings 工具更新它们。

{
  "language": "en",
  "tone": "formal",
  "writing_style": "clear_and_concise",
  "sender_name": "Ahmed Samir",
  "organization_name": "Kalima Tech",
  "include_signature": true,
  "signature": "Best regards,\n{{sender_name}}\n{{organization_name}}",
  "preferred_greeting": "Dear {{recipient_name}},",
  "auto_adjust_tone": true,
  "include_thread_context": true,
  "character_limit": 1000,
  "prompt_prefix": "You are an AI email assistant for {{organization_name}}. Keep messages professional, polite, and to the point.",
  "default_provider": "google"
}

---

📦 支持的工具

工具	描述
send_email	编写并发送消息
read_email	获取并检查消息
create_draft	准备消息
send_draft	最终发送
search_email	使用语义过滤器查询收件箱
toggle_label	修改类别/标签
archive_email	清理收件箱
reply_email	在线程上下文中回复
delete_email	删除消息
load_email_settings	查看当前电子邮件设置
update_email_settings	更新运行时电子邮件设置

---

🤝 贡献

MailNet 服务器是模块化且可扩展的。要添加新的提供商，请子类化基础客户端并实现预定义的钩子。欢迎提交 PR！