Emailassistant

EmailAssistant MCP Server

AI 搭載のメールアシスタントです。自然言語を使ってメールを送信、解析、管理できます。4 つのツール（smart_email、parse_email_intent、send_email、email_chat）を備えた MCP サーバーです。SSE/stdio トランスポートと Bearer Token 認証に対応しています。

---

EmailAssistant - AI メールアシスタント

自然言語でメールを送信できるスマートアシスタントです。GUI、API、MCP Server の 3 通りの方法で利用できます。

機能

• 自然言語でメールを送信 — 「[email protected] に会議のお知らせを送って」と一言伝えるだけで完了します
• 複数モデルによる意図解析 — 智谱 GLM / DeepSeek / 通义千问 / Claude / ローカルルール
• 添付ファイルに対応 — ファイルパスを自動認識して添付します
• MCP Server — Claude Code / Claude Desktop などの AI ツールから直接呼び出せます

クイックスタート

方法 1：Windows へのインストール

# 1. 一键安装
双击 install.bat

# 2. 编辑配置（填入 LLM API Key）
编辑 config.json

# 3. 一键启动（API + GUI）
双击 start_all.bat

方法 2：Docker

# 1. 准备配置
cp config.example.json config.json
# 编辑 config.json 填入 API Key

# 2. 启动
docker-compose up -d

# 3. 如需 MCP SSE 模式
docker-compose --profile mcp-sse up -d

前提条件

• Python 3.10 以降（Windows へのインストール時）
• 実際のメール送信には、EmailMarketer サービスが localhost:8100 で稼働している必要があります

設定

config.json を編集します。

項目	説明
model	現在使用するモデル：zhipu / deepseek / qwen / claude / local
models.*.api_key	対応するモデルの API Key
emailmarketer.api_url	EmailMarketer API のアドレス（デフォルトは http://localhost:8100）
emailmarketer.api_key	EmailMarketer API Key

API Key を設定したくない場合は、local モードを選択してください。ローカルルールで解析します（インターネット接続は不要です）。

API インターフェース

起動：python run_api.py（ポート 8200）

メソッド	パス	説明
GET	/api/v1/health	ヘルスチェック
POST	/api/v1/parse	意図解析（{"message": "..."} → 構造化 JSON）
POST	/api/v1/send	メールを直接送信（to_email、subject、body、attachment_path）
POST	/api/v1/chat	ワンステップで処理：解析 → メール送信またはチャットで返信

MCP Server との統合

Claude Code

プロジェクトのルートディレクトリにある .mcp.json に追加します。

{
  "mcpServers": {
    "email-assistant": {
      "command": "python",
      "args": ["<路径>/EmailAssistant/run_mcp.py"],
      "cwd": "<路径>/EmailAssistant",
      "env": {
        "EA_API_URL": "http://localhost:8200"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に同じ設定を追加します。

MCP ツール

ツール	説明
smart_email(message)	自然言語でメールを送信
parse_email_intent(message)	意図の解析のみを実行し、送信はしません
send_email(to_email, subject, body, attachment_path)	メールを直接送信
email_chat(message)	スマートチャット

SSE モード

python run_mcp.py --transport sse --port 8201

ポート割り当て

サービス	ポート
API	8200
MCP SSE	8201

プロジェクト構成

EmailAssistant/
├── main.py              # GUI 主程序
├── intent_parser.py     # 意图解析引擎
├── email_client.py      # EmailMarketer API 客户端
├── config_manager.py    # 配置管理
├── config.json          # 运行配置
├── config.example.json  # 配置模板
├── run_api.py           # FastAPI 服务
├── run_mcp.py           # MCP Server
├── requirements.txt     # Python 依赖
├── install.bat          # Windows 一键安装
├── start_all.bat        # Windows 一键启动
├── Dockerfile           # Docker 镜像
└── docker-compose.yml   # Docker 编排