Клиент Eve MCP

eve-client — это локальный установщик и CLI для интеграции поддерживаемых ИИ-инструментов с облачным сервисом памяти Eve.

Он обнаруживает локальные инструменты, настраивает MCP, устанавливает управляемые Eve файлы промптов и хуков (где это поддерживается), управляет аутентификацией, а также позволяет проверять, исправлять или удалять интеграцию в дальнейшем. Он также может импортировать локальную историю из поддерживаемых клиентов.

Как работает Eve

Когда вы запускаете eve install, Eve настраивает четыре хука жизненного цикла, которые работают автоматически — во время сессий не требуется вводить дополнительные команды.

Хуки жизненного цикла доступны в Claude Code и Gemini CLI. Eve также подключается к Codex CLI и другим MCP-совместимым клиентам с помощью внедрения промптов, поэтому вы получаете доступ к памяти во всех своих инструментах.

Related MCP server: Sovereign Universal Memory MCP

Быстрый старт — 5 минут

1. Получите рабочее пространство Eve

Запросите доступ на evemem.com. После подготовки пространства войдите в систему и создайте API-ключ на странице evemem.com/app/overview.

2. Установите клиент

uv tool install git+https://github.com/sherifkozman/eve-mcp.git

Нет uv? Используйте:

pipx install git+https://github.com/sherifkozman/eve-mcp.git

Проверка: eve version

3. Подключите Claude Code (замените --tool gemini-cli для Gemini CLI)

eve connect --tool claude-code --api-key <your-eve-api-key>

Это объединяет аутентификацию, установку и проверку. Пошаговое руководство см. в разделе API key flow ниже.

Ожидаемый вывод:

✓ MCP config written
✓ CLAUDE.md companion updated
✓ Lifecycle hooks configured — Eve auto-injects memory context on every session
✓ Eve memory is connected and responding

Что только что произошло? Eve установила четыре хука жизненного цикла. С этого момента каждая сессия Claude Code начинается с предварительно загруженного контекста вашей памяти и заканчивается сохранением новых знаний. Вам никогда не нужно просить Claude использовать Eve.

Если eve connect завершается ошибкой: выполните eve doctor --tool claude-code и проверьте вывод диагностики. Откройте issue на github.com/sherifkozman/eve-mcp.

Установка

Перед установкой клиента получите рабочее пространство Eve:

• Запросить доступ: https://evemem.com

• После того как ваше рабочее пространство будет подготовлено, войдите в панель управления Eve:

  • https://evemem.com/app/overview

• Если вы планируете использовать аутентификацию по API-ключу, создайте или обновите ключ арендатора в процессе настройки администратора/пользователя Eve перед подключением клиента.

Из GitHub сейчас

Рекомендуемый способ:

uv tool install git+https://github.com/sherifkozman/eve-mcp.git

Альтернатива:

pipx install git+https://github.com/sherifkozman/eve-mcp.git

Или через автономный bash-установщик:

curl -fsSL https://raw.githubusercontent.com/sherifkozman/eve-mcp/main/install.sh | bash

Затем подтвердите:

eve version
eve --help

Ручная настройка (без установщика)

См. examples/ для готовых фрагментов конфигурации MCP для Claude Code, Gemini CLI и Codex CLI.

Из PyPI позже

После публикации установка пакета будет выглядеть так:

uv tool install eve-client

или:

pipx install eve-client

Что делает клиент Eve

• обнаруживает поддерживаемые локальные ИИ-клиенты

• показывает план установки перед изменением файлов

• записывает управляемую Eve конфигурацию MCP

• устанавливает файлы промптов/компаньонов, где это поддерживается

• устанавливает четыре хука жизненного цикла, которые автоматически внедряют контекст памяти в каждую сессию (SessionStart, UserPromptSubmit, PreCompact, Stop)

• хранит аутентификационные данные локально, используя файловое хранилище учетных данных

• предоставляет команды eve memory search и eve memory status для прямого доступа к памяти

• проверяет, исправляет, откатывает и удаляет изменения, управляемые Eve

• импортирует локальную историю разговоров в Eve из поддерживаемых клиентов

Импорт локальной истории

Поддерживаемые источники импорта на текущий момент:

• Claude Code

• Codex CLI

• Gemini CLI

Основные команды:

eve import scan --source claude-code
eve import preview --source claude-code --path <session_file>
eve import jobs                              # list scan jobs
eve auth login --tool claude-code
eve import upload --job <scan_job_id> --use-auth-from claude-code
eve import runs                              # list upload runs
eve import resume --run <run_id>
eve import cleanup --days 30
eve import cleanup --days 30 --apply

Как это работает:

• анализирует локальную историю на вашем компьютере

• загружает нормализованные пакеты в управляемый сервис Eve

• ведет локальный реестр SQLite для задач сканирования, загрузки, повтора и возобновления

• по умолчанию поддерживает очистку старых завершенных локальных задач импорта (dry-run)

Обслуживание импортера:

• eve import cleanup — это общая команда обслуживания локального реестра, а не функция конкретного источника импорта клиента

Примечание по аутентификации:

• по возможности избегайте передачи секретов напрямую в командной строке

• предпочтительнее сначала выполнить eve auth login ..., а затем запускать команды импортера без повторного ввода API-ключа

• в интерактивной оболочке eve auth login --tool claude-code запрашивает ключ безопасным способом

Примечание по текущему развертыванию:

• корректность и возобновление работают стабильно

• очень большие импорты, особенно с большим количеством данных Claude, могут быть медленнее, чем хотелось бы, пока продолжается настройка параметров пакетной обработки

Поддерживаемые клиенты

Claude Code

Поддерживается сегодня:

• MCP конфигурация

• файл-компаньон CLAUDE.md

• хуки, управляемые пакетом

• поддержка импортера: scan, preview, upload, resume

Основной путь аутентификации сегодня:

• API-ключ Eve

Gemini CLI

Поддерживается сегодня:

• MCP конфигурация

• файл-компаньон GEMINI.md

• хуки, управляемые пакетом

• поддержка импортера: scan, preview, upload, resume

Основной путь аутентификации сегодня:

• API-ключ Eve

Codex CLI

Поддерживается сегодня:

• MCP конфигурация

• OAuth-логин от Eve

• внедрение bearer-токена во время выполнения

• поддержка импортера: scan, preview, upload, resume

Основной путь аутентификации сегодня:

• Eve OAuth

Важно:

• нативный логин Codex MCP не является поддерживаемым путем Eve

Claude Desktop

Локально не настраивается автоматически для облачного Eve.

Требования к аутентификации

Вам нужно рабочее пространство Eve и одно из следующего:

• API-ключ Eve, или

• доступ Eve OAuth для поддерживаемых потоков

Текущие ожидания по аутентификации:

• Claude Code: API-ключ

• Gemini CLI: API-ключ

• Codex CLI: Eve OAuth

Поток OAuth в браузере существует для большего числа клиентов, но он все еще является экспериментальным вне пути Codex и пока не должен рассматриваться как стандартный поток установки для продакшена.

Базовое использование

Первый запуск

eve quickstart
eve connect --tool claude-code
eve verify --tool claude-code

Поток API-ключа

eve auth login --tool claude-code --api-key <eve-key>
eve install --tool claude-code --apply --yes  # --apply writes config, --yes skips confirmation
eve verify --tool claude-code

Поток Codex OAuth

eve auth login --tool codex-cli --auth-mode oauth
eve install --tool codex-cli --auth-mode oauth --apply --yes
eve verify --tool codex-cli --auth-mode oauth

Команды памяти

eve memory search "what database do we use" --context naya
eve memory search "auth patterns" --limit 5 --json
eve memory status
eve memory status --json

Общие команды

eve quickstart
eve connect
eve install --dry-run
eve install --apply --yes --tool claude-code
eve status
eve doctor
eve verify
eve repair --tool gemini-cli --apply --yes
eve uninstall --tool claude-code --yes
eve run --tool codex-cli -- exec "Use Eve memory to search for my latest preference."

Ручная настройка MCP

Если вы не хотите, чтобы установщик редактировал конфигурацию клиента за вас, добавьте облачный MCP-сервер Eve вручную.

Общая облачная конечная точка MCP

https://mcp.evemem.com/mcp

Claude Code / Gemini CLI (API-ключ)

Используйте API-ключ арендатора из панели администратора Eve.

{
  "eve-memory": {
    "type": "http",
    "url": "https://mcp.evemem.com/mcp",
    "headers": {
      "X-API-Key": "eve_<tenant>_...",
      "X-Source-Agent": "claude_code"
    }
  }
}

Для Gemini сохраните ту же структуру и измените:

X-Source-Agent = gemini_cli

Codex CLI (OAuth)

Codex должен использовать bearer-токен, принадлежащий Eve, а не нативный codex mcp login.

[mcp_servers.eve-memory]
url = "https://mcp.evemem.com/mcp"
bearer_token_env_var = "EVE_CODEX_BEARER_TOKEN"
startup_timeout_sec = 60

[mcp_servers.eve-memory.headers]
X-Source-Agent = "codex_cli"

Ресурс OAuth:

https://mcp.evemem.com/mcp

Внедрение промптов Codex должно находиться в файле AGENTS.md активного проекта. Eve управляет своим собственным помеченным блоком внутри этого файла, вместо создания параллельного вспомогательного файла.

Другие MCP-клиенты

Для других удаленных MCP-клиентов минимальная рабочая настройка:

1. URL MCP:

https://mcp.evemem.com/mcp

2. Заголовок исходного агента:

X-Source-Agent: your_client_name

3. Выберите один стиль аутентификации:

• API-ключ:

X-API-Key: eve_<tenant>_...

• OAuth bearer:

Authorization: Bearer <token>

4. Для клиентов с поддержкой OAuth используйте этот идентификатор ресурса:

https://mcp.evemem.com/mcp

5. Необходимые области доступа (scopes):

memory.read
memory.write

Если клиент поддерживает файл инструкций-компаньон, укажите его на активный файл инструкций для этого инструмента, вместо создания второго параллельного файла.

Какой путь аутентификации использовать

• Claude Code: API-ключ

• Gemini CLI: API-ключ

• Codex CLI: Eve OAuth

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

Модель безопасности

• отсутствие скрытых изменений профиля оболочки

• отсутствие недокументированных хуков

• отсутствие перезаписи файлов инструкций, созданных пользователем

• резервное копирование и отслеживание манифеста перед изменением

• поддержка явного отката и удаления

• удаление очищает учетные данные и записи инструментов, управляемые Eve, и предупреждает, когда файл, принадлежащий Eve и измененный пользователем, требует ручной проверки

Разработка

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

uv run pytest --cov=eve_client --cov-report=term-missing -q tests

Сборка артефактов Python:

uv build .

Проверка артефактов сборки:

uvx twine check dist/*

Сборка автономных артефактов релиза:

bash scripts/build-eve-client-release.sh

Лицензия

Apache-2.0. См. LICENSE.