Ambient Context MCP
Приложение в меню macOS пишет текст активных окон за день в markdown, а MCP-сервер отдает эту запись агенту
- 207 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Приложение читает текст активного окна, включая почту и чаты, и складывает его в файлы, где могут оказаться чувствительные данные
- Фильтр паролей, ключей и карт работает по эвристикам, поэтому гарантии полной очистки нет
- Агент через MCP читает всю запись и может включать и выключать съемку, а значит видит содержимое ваших писем и документов
Установка
- Работает в
Ручная установка
claude mcp add --scope user --transport stdio ambient-context -- "/Applications/Ambient Context.app/Contents/MacOS/ambient-context" mcpДля Claude Desktop, Cursor, Zed и других клиентов stdio готовые фрагменты лежат в `docs/mcp.md`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Приложение читает текст активного окна, включая почту и чаты, и складывает его в файлы, где могут оказаться чувствительные данные
- Фильтр паролей, ключей и карт работает по эвристикам, поэтому гарантии полной очистки нет
- Агент через MCP читает всю запись и может включать и выключать съемку, а значит видит содержимое ваших писем и документов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Ambient Context — открытое приложение для строки меню macOS. Пока значок-глаз открыт, оно каждые несколько секунд читает текст активного окна через дерево доступности и дописывает его в markdown-файлы дня в выбранной вами папке. Скриншотов, видео и распознавания текста нет, только текст из системного интерфейса доступности. В назначенное время или по кнопке «Process day» агент, уже установленный у вас (Claude Code, Codex или opencode), превращает запись в две вещи: базу знаний из шести страниц со ссылками на блоки записи (люди, обязательства, обсуждения, продукты, проблемы, чтение) и письменную сводку дня. Само приложение к моделям не обращается. Тот же бинарник работает как MCP-сервер, который запускается подкомандой `mcp` по stdio. Двадцать инструментов читают дни, ищут по записи, отдают базу знаний и сводки и управляют съемкой: `list_days`, `read_day`, `read_summary`, `read_kb`, `search_record`, `start_capture`, `stop_capture` и другие. Инструменты чтения работают при закрытом приложении, изменяющие идут через запущенное приложение, и каждая запись попадает в журнал дня с именем клиента. В настройках можно поставить пять скиллов: «catch me up», standup, недельный обзор, настройку правил и общий цикл.
Для кого. Пользователям Mac на Apple Silicon, которые весь день читают письма, тикеты и документы и хотят, чтобы агент знал это без ручной вставки.
Подходит, если
- К четырем часам вечера агенту нужен контекст дня: письма, тикеты и созвоны, которые остались только на экране
- Утром надо быстро вспомнить, над чем работали вчера, и получить заметки для стендапа
- Нужно найти, в какой вкладке или файле встретилась цитата, и открыть исходный документ
- Требуется база знаний о людях и обязательствах, где каждое утверждение ссылается на блок записи
- Недельный обзор собирается из дневных сводок без ручной работы
Не подходит, если
- Компьютер на Intel или macOS старше 14: приложение рассчитано на Apple Silicon и macOS 14 и новее
- Работа идет в терминалах Kitty и Alacritty или в программах без доступного текста: они отдают мало или ничего
- На экране постоянно секретные материалы или чужие персональные данные, которые нельзя записывать даже локально
- Нужна запись звука, видео или скриншотов: приложение читает только текст
Пример запроса к агенту
Подготовь заметки для стендапа по вчерашнему дню: что я делал, с кем договорился и какие обязательства остались.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны Mac на Apple Silicon с macOS 14 и новее и разрешение «Универсальный доступ». Приложения на Chromium и Electron (Chrome, Slack, VS Code, Obsidian, Figma) строят дерево доступности при первом обращении, поэтому первые секунды записи в них неполные. Терминалы с отрисовкой на GPU вроде Kitty и Alacritty отдают мало текста, а Terminal.app и iTerm2 работают.
Пароли в защищенных полях, менеджеры паролей и приватные окна браузера пропускаются. Строки, похожие на ключи и номера карт, заменяются на `[redacted]`. Автор называет это эвристикой, а не гарантией: папку с записью стоит считать чувствительной. Выбранный агент и синхронизируемая папка (iCloud, Dropbox) относятся к отдельным решениям о доверии.
Как отключить. Нажмите на значок-глаз в строке меню: запись остановится и останется выключенной после перезапуска. Из Claude Code сервер убирает команда `claude mcp remove ambient-context`. Записанные дни лежат в обычных markdown-файлах в вашей папке, их можно удалить как любые файлы.
Частые вопросы
Как подключить Ambient Context к Claude Code?
Установите приложение из DMG и выполните `claude mcp add --scope user --transport stdio ambient-context -- "/Applications/Ambient Context.app/Contents/MacOS/ambient-context" mcp`. Для Claude Desktop, Cursor и Zed в документации `docs/mcp.md` лежат готовые фрагменты конфигурации.
Что записывается?
Текст активного окна из дерева доступности, не чаще раза в несколько секунд и не при заблокированном экране. Скриншотов, видео и распознавания текста нет. В записи сохраняется время, приложение и путь к файлу или адрес страницы, где приложение их отдает.
Куда уходят данные?
Никуда. У приложения нет учетной записи, сервера и телеметрии, а проверка обновлений обращается только к релизам на GitHub. Запись лежит в вашей папке. Данные передаются наружу только тому агенту, которого вы сами подключили для обработки дня.
Нужен ли отдельный ключ или платная модель?
Нет: приложение не обращается к моделям само. Базу знаний и сводку строит ваш агент (Claude Code, Codex или opencode) по вашей подписке, и для длинного входа можно выбрать более дешевую модель, а для сводки более сильную.
Что делают скиллы из настроек?
Пять скиллов (catch me up, standup, weekly review, tune rules и общий цикл) ставятся в `~/.claude/skills/` и `~/.agents/skills/`, чтобы агент сам знал, когда обратиться к записи. Их читают Claude Code, Cursor, Codex, Zed, Copilot, Gemini CLI, Goose и OpenCode.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПриложение для macOS помнит, что было на экране, и открывает агентам историю по MCP: поиск, дни, потоки работы, скриншоты.
Локальная база заметок в Markdown с MCP-сервером и скиллами: Claude Code, Cursor, Codex и Gemini CLI читают один и тот же контекст
Приложение для macOS ведет приватную ленту вашей работы, а локальный MCP-сервер отвечает агенту, что вы делали и что осталось.
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Приложение для macOS собирает ваши знания в Markdown-папку и по желанию открывает ее ИИ-клиентам через зашифрованное MCP-зеркало с двумя инструментами
Коротко о README
В описании сначала разобрана проблема: контекст дня остается на экране и не доходит до ассистента. Дальше показано, как выглядит день на диске (`apps.md`, `websites.md`, `messages.md`, база знаний `KB/`, сводки `Summaries/`), как включить запись и какие правила приватности действуют. Подробности о границах доверия лежат в `docs/privacy-and-security.md`.