outlook-bridge

MCP-сервер для поиска и чтения почты в Outlook classic (Windows, через COM) — list_folders, search_mail, read_mail, get_thread, read_attachment. Полный дизайн см. в docs/superpowers/specs/2026-08-24-outlook-bridge-design.md, план реализации — в docs/superpowers/plans/2026-08-24-outlook-bridge-a.md.

Только чтение — нет инструментов записи

Этот сервер не имеет send_mail, delete_mail, move_mail, mark_as_read или любых других инструментов, изменяющих/удаляющих/отправляющих почту. Ни один метод в Win32MailStore не вызывает .Send(), .Save(), .Delete(), .Move(), .MarkAsRead() и не присваивает значения какому-либо свойству Outlook. Единственное исключение: read_attachment записывает вложение во временную папку, создаваемую самим сервером (tempfile.TemporaryDirectory), для извлечения текста, а затем немедленно удаляет эту папку — SaveAsFile — это API чтения, ничего в Outlook не изменяет.

Related MCP server: outlook-mcp

Запуск на Linux (машина разработчика) — FakeMailStore

Outlook не нужен, Windows не нужен. FakeMailStore загружает YAML-фикстуру (~50 синтетических писем: несколько папок, несколько хранилищ, диалоговые цепочки, вложения всех типов, письма на вьетнамском, длинные тела писем, пустые письма, элементы, не являющиеся письмами) и реализует тот же интерфейс MailStore, который реализует Win32MailStore.

python -m venv .venv
.venv/bin/pip install -e ".[dev]"

# Chạy server với store giả (không cần Outlook)
OUTLOOK_BRIDGE_FAKE=1 OUTLOOK_BRIDGE_FIXTURE=tests/fixtures/mailbox.yaml \
  .venv/bin/python server.py

Запуск тестов

Linux (большая часть логики — чистый Python + FakeMailStore):

.venv/bin/pytest

Windows (набор контрактных тестов, ОБЩИЙ для обоих хранилищ — это единственный способ доказать, что Win32MailStore действительно соответствует поведению FakeMailStore, а не просто «работает»):

set OUTLOOK_BRIDGE_CONTRACT_WIN32=1
.venv\Scripts\pytest tests/contract -v

Некоторые случаи в этом наборе намеренно SKIP на реальном почтовом ящике (данные есть только в фикстуре FakeMailStore) — см. раздел «Намеренные SKIP-тесты» в docs/WINDOWS-RUNBOOK.md, прежде чем считать SKIP признаком проблемы.

См. docs/INSTALL-windows.md для установки и регистрации MCP-сервера на Windows, и docs/WINDOWS-RUNBOOK.md — для порядка действий при первой работе за реальной Windows-машиной.

Диагностика окружения — doctor.py

python doctor.py            # trên Linux: báo "không phải Windows", degrade an toàn
python doctor.py --verbose  # trên Windows: thêm chi tiết root.Name, cây folder, giá trị raw

Два риска, которые никто пока не решил (спецификация §13)

R2 — New Outlook постепенно заменит Outlook classic, и COM исчезнет вместе с ним. Microsoft принудительно мигрирует пользователей на New Outlook, который не регистрирует COM-сервер (doctor.py сообщает com_ok: False, когда это происходит). Это ограниченный по сроку инструмент, а не исправимая ошибка. Единственный выход, когда это произойдёт, — переписать Win32MailStore на основе Microsoft Graph API — архитектура проекта (все детали COM находятся только в двух файлах, win32_store.py и doctor.py) ограничивает ущерб переписыванием именно этих двух файлов, а не всей системы.

R3 — Содержимое внутренней корпоративной почты проходит через API Anthropic. COM работает полностью локально (ничего не покидает машину для чтения почты), но чтобы Claude отвечал на основе содержимого письма, это содержимое должно быть отправлено в API. Это неотъемлемый компромисс использования ИИ-ассистента для чтения почты — ни один сервер не решит это за вас.

Единственная мера контроля: folder_allowlist в config.toml. Установите его в список конкретных папок (в формате store-qualified, например "Mailbox - Nguyen Van A/Inbox"), чтобы ограничить область почты, которую этот сервер может видеть — письма вне allowlist не читаются ни одним инструментом, ни через какой вызов (поиск, чтение по id, чтение цепочки, загрузка вложений), даже если диалоговая цепочка пересекает границу allowlist.

Совпадение — ТОЧНОЕ, а не по префиксу. Разрешение "Inbox" НЕ включает "Inbox/Bao cao" — каждая папка, которую нужно разрешить, должна быть перечислена отдельно. Это осознанный дизайнерский выбор, а не ограничение: allowlist по префиксу легко может случайно пропустить чувствительную вложенную папку, о которой настройщик не подумал. Если folder_allowlist не настроен (по умолчанию пустой список), читаются все папки в почтовом ящике — настройте его перед тем, как направлять этот сервер на реальный корпоративный почтовый ящик. См. шаг 2 в docs/WINDOWS-RUNBOOK.md, чтобы узнать, как получить правильные имена папок в формате store-qualified из list_folders.

Если нужно ужесточить ещё сильнее: сузьте folder_allowlist до нескольких конкретных папок, или — если этого всё ещё недостаточно — рассмотрите возврат только метаданных и сниппета вместо полного содержимого письма (сейчас ни один инструмент этого не делает; потребуется новый инструмент).