Graph Mail MCP

Локальный stdio-сервер Model Context Protocol для почты Microsoft 365. Он обеспечивает контролируемые рабочие процессы поиска, чтения, обсуждений, вложений и черновиков Outlook/Exchange Online через Microsoft Graph.

Он никогда не отправляет, не удаляет, не перемещает, не копирует, не архивирует и не помечает сообщения как прочитанные. Сырые URL-адреса Graph, сырые OData и неограниченные запросы Graph не предоставляются.

Требования

• Windows с Microsoft Edge

• Node.js 22+

• Рабочая или учебная учетная запись Microsoft 365 с Exchange Online

• Делегированное разрешение Mail.ReadWrite

Личные учетные записи Microsoft отключены по умолчанию. Общие почтовые ящики дополнительно требуют делегирования Exchange и разрешения Mail.ReadWrite.Shared.

Установка

git clone https://github.com/hanhandly/graph-mail-mcp.git
Set-Location graph-mail-mcp
npm ci
npm run build
Copy-Item config.example.json config.local.json

Файл config.local.json игнорируется Git. Проверьте его перед аутентификацией, особенно tenant, allowedMailboxScopes и настройки общего почтового ящика.

Аутентификация

node dist\cli.js -c config.local.json doctor
node dist\cli.js -c config.local.json auth login --account-hint user@contoso.com
node dist\cli.js -c config.local.json auth status

Вход открывает изолированный профиль Microsoft Edge и использует Graph Explorer для делегированной аутентификации. Playwright нажимает Sign in, выбирает указанную учетную запись и проверяет, было ли уже предоставлено необходимое разрешение на почту. Если да, аутентификация продолжается автоматически; в противном случае CLI сообщает пользователю, какое разрешение необходимо предоставить. Playwright никогда не нажимает Consent. MFA и подтверждение согласия остаются под контролем пользователя. auth status возвращает только метаданные и никогда не отображает токен.

Настройка MCP-клиента

Используйте абсолютные пути в конфигурации MCP клиента:

{
  "mcpServers": {
    "graph-mail": {
      "command": "node",
      "args": [
        "C:\\Tools\\graph-mail-mcp\\dist\\cli.js",
        "-c",
        "C:\\Tools\\graph-mail-mcp\\config.local.json",
        "serve"
      ],
      "cwd": "C:\\Tools\\graph-mail-mcp"
    }
  }
}

Некоторые клиенты используют другой внешний ключ, но значения command, args и cwd одинаковы. Держите -c <config-path> перед serve. Сервер использует stdio и не открывает сетевой порт.

Перезапустите MCP-клиент, затем вызовите:

1. mail_auth_status

2. mail_list_folders

3. mail_search_messages

Инструменты

Обновления черновиков ограничены черновиками, созданными и зарегистрированными этим MCP. Инструмента отправки нет.

Безопасность

Транспорт Graph использует межсетевой экран с политикой запрета по умолчанию и типизированный компилятор запросов. Токены хранятся вне репозитория и по умолчанию защищены с помощью Windows DPAPI. Журналы и ответы инструментов не должны раскрывать токены доступа, файлы cookie или заголовки авторизации.

Graph Explorer может возвращать разрешения, ранее предоставленные его общему приложению. Сервер отклоняет Mail.Send и ограничивает запросы во время выполнения, но развертывания, требующие строго минимально привилегированного токена, должны использовать выделенную регистрацию приложения или ограниченного поставщика аутентификации.

См. Security, Tool reference, Configuration example и Architecture.