Friday MCP

Слой постоянной памяти для кодинг-агентов на вашем сервере: решения, схемы и ограничения живут между сессиями через MCP.

  • 67 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • Служба хранит решения, схемы и ограничения проекта и открывает API по ключу.
  • Установка запускает скрипт из сети и занимает локальные порты.
Все причины и проверки

friday-memory/friday

Установка

Ручная установка

claude mcp add friday -e FRIDAY_URL="http://localhost:8000" -e BRAIN_API_KEY="your_secret_key" -- python -m mcp.server

Сначала поднимите службу Friday. Значения переменных подставьте свои.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Служба хранит решения, схемы и ограничения проекта и открывает API по ключу.
  • Установка запускает скрипт из сети и занимает локальные порты.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Friday работает как фоновая служба и хранит решения по архитектуре, схемы и ограничения проекта в четырех уровнях памяти. Агент обращается к ней через семь MCP-инструментов: `add_memory` сохраняет решения с обоснованием, `add_fact` записывает версионируемые факты, `memory_search` ищет по смыслу, `get_context` собирает многоуровневый контекст, `get_blast_radius` обходит граф зависимостей, а `delete_memory` и `revoke_fact` удаляют устаревшее и конфликтующие факты. Служба запускается через Docker Compose: установочный скрипт проверяет Docker, занимает порты 8000, 7474 и 7687, создает секреты и `.env`. Один и тот же сервер подключается к Cursor, Claude Code, Antigravity и VS Code, поэтому память общая для разных инструментов. Есть Python SDK и интерфейс Neural Studio для просмотра графа знаний.

Для кого. Разработчикам, которые работают с несколькими агентами в одном проекте и теряют контекст при каждой новой сессии.

Подходит, если

  • Решения по архитектуре и схеме данных остаются доступными после закрытия чата.
  • Перед рефакторингом хочется узнать по графу зависимостей, какие части системы он затронет.
  • Cursor и Claude Code работают с одной общей памятью проекта.
  • Устаревшие или конфликтующие факты отзываются и версионируются.

Не подходит, если

  • Нет Docker или возможности держать фоновую службу и порты 8000, 7474, 7687.
  • Достаточно файла правил в репозитории для небольшого проекта.
  • Память нельзя хранить на вашем сервере.

Пример запроса к агенту

Сохрани в Friday решение использовать PostgreSQL для заказов и покажи, какие сервисы затронет смена схемы.

MCP

Транспорт
stdio, http
Авторизация
API-ключ

Переменные окружения

FRIDAY_URL обязательная
Адрес службы Friday, например http://localhost:8000.
BRAIN_API_KEY обязательная, секрет
Секретный ключ API службы Friday.

Ограничения

Нужны Docker и свободные порты 8000, 7474 и 7687, служба хранит данные проекта на вашей машине или сервере. Установка запускает скрипт через `curl | bash`: сначала прочитайте `install.sh`. API защищен секретом `BRAIN_API_KEY`, держите его вне репозитория. Для удаленного сервера клиент подключается по SSH, а память накапливает все, что агент в нее записал, включая чувствительные решения. Качество ответов зависит от того, что агент записал в память: записи нужно проверять и отзывать устаревшие командой `revoke_fact`.

Как отключить. Удалите запись `friday` из MCP-конфигурации клиента, остановите службу командой `docker compose down` в папке проекта и удалите тома с данными, если память больше не нужна.

Частые вопросы

Как подключить Friday к Claude Code?

Командой `claude mcp add friday -e FRIDAY_URL="http://localhost:8000" -e BRAIN_API_KEY="..." -- python -m mcp.server`, значения подставьте свои.

Какие инструменты MCP есть?

Семь: `add_memory`, `add_fact`, `memory_search`, `get_context`, `get_blast_radius`, `delete_memory` и `revoke_fact`.

Можно ли работать с удаленным сервером?

Да, клиент вызывает сервер по SSH, например через `docker exec -i fridays-brain-app python /app/mcp_server/server.py`.

Какие порты занимает служба?

Порты 8000, 7474 и 7687. Установочный скрипт распределяет их сам.

Есть ли SDK?

Да, Python-пакет `friday-memory` на PyPI. Адрес и ключ он берет из окружения `FRIDAY_URL` и `FRIDAY_API_KEY`.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API

MCP-серверРасширенный доступ2,1 тыс.Звезды репозитория

MCP-сервер долговременной памяти на вашем сервере: хранит предпочтения и решения между разговорами в Claude Code и Cursor

MCP-серверРасширенный доступ283Звезды репозитория

Постоянная память агента на графе связей: решения и ошибки переживают сессию, без векторной базы и платных вызовов API

MCP-серверРасширенный доступ244Звезды репозитория

Самостоятельный MCP-сервер долговременной памяти для агентов: структурированные записи, версии с откатом и визуальная панель

MCP-серверРасширенный доступ1,4 тыс.Звезды репозитория

MCP-сервер постоянной памяти для агентов: наблюдения, убеждения, цели и ночная консолидация знаний в 60 инструментах.

MCP-серверРасширенный доступ51Звезды репозитория

MCP-сервер и API общей памяти для нескольких агентов: факты, решения и события хранятся в одной базе с поиском по смыслу.

MCP-серверРасширенный доступ64Звезды репозитория

Коротко о README

Репозиторий описывает проблему амнезии сессий, архитектуру из нескольких слоев памяти, жизненный цикл записей и настройку клиентов. Есть бенчмарки на DeepEval и рассылаемые правила для нескольких агентов.

Бейдж для README

Сообщить о проблеме