ai-engineering-brain

Внутренняя инженерная платформа знаний для Claude Code и других MCP-агентов: объединяет внутренние документы, репозитории кода и долговременную память в единый MCP Gateway, а также управляет документами, учетными записями и MCP-ключами через админ-панель.

В настоящее время наиболее зрелым и прошедшим сквозное тестирование в Docker является конвейер базы знаний kb-mcp. code-mcp и mem-mcp уже подключены к единому агрегирующему интерфейсу MCP, но все еще находятся на стадии каркаса/постоянного совершенствования.

Полный статус реализации проекта, причины сбоев и способы их устранения см. в docs/kb-mcp-project-status.md.

Возможности

• База знаний: импорт Markdown, TXT, DOCX; сохранение иерархии заголовков, таблиц, блоков кода и цитат; родительско-дочернее разбиение на чанки; гибридный поиск Qdrant dense+sparse, RRF, опциональный реранкер.

• Администрирование: страница управления EASTCOM, загрузка/повтор/удаление документов, очистка записей об отсутствующих файлах, вход в учетную запись и RBAC.

• MCP-ключи, привязанные к учетной записи: после входа в систему пользователь может создавать, просматривать, копировать, показывать/скрывать и отзывать свои MCP-ключи; полные ключи хранятся в зашифрованном виде и не записываются в журналы.

• Единый MCP: клиент подключается только к одному адресу /mcp шлюза; шлюз агрегирует инструменты kb_*, code_*, mem_*.

• Развертывание в локальной сети: сервис работает на одном Docker-хосте, другие агенты получают доступ к шлюзу через локальную сеть.

Related MCP server: MCP Gateway

Архитектура

Claude Code / Other Agents
          │  HTTP MCP + Bearer MCP Key
          ▼
Gateway :8000/mcp  ← 唯一对外 MCP 接口
          │
    ┌─────┼─────────────┐
    ▼     ▼             ▼
 kb-mcp  code-mcp      mem-mcp
 :8100   :8101         :8102
    │       │             │
    └───────┴──────┬──────┘
                   ▼
          Postgres + Qdrant

Admin :9001  ← 文档、账户、MCP Key 管理页面

Внешним клиентам нужно знать только:

MCP:   http://<服务器局域网IP>:8000/mcp
Admin: http://<服务器局域网IP>:9001/

Внутренние 8100/8101/8102 не нужно настраивать для других агентов.

Именование инструментов

Инструменты в едином MCP используют префиксы сервисов:

kb_search
kb_list_documents

code_search_code
code_grep_code
code_query_git_history
code_get_commit_diff
code_get_file_at_version

mem_save_memory
mem_search_memory

В настоящее время некоторые инструменты code-mcp и mem-mcp все еще являются каркасной реализацией; в дальнейшем их можно будет дополнять без изменения адреса клиента.

Быстрая установка

Предварительные требования

• Docker Desktop (Windows + WSL2) или Docker Engine + Docker Compose v2;

• Linux/macOS: Bash, curl, openssl, Python 3;

• Windows: PowerShell, Docker Desktop;

• Если требуется загрузка моделей, хост/контейнер должен иметь доступ к Hugging Face; если прямое подключение невозможно, подготовьте HTTP-прокси.

Linux / macOS

git clone https://github.com/arui-git/ai-engineering-brain.git
cd ai-engineering-brain
chmod +x install.sh
./install.sh

Скрипт установки задаст интерактивные вопросы:

• MCP_KEY_ENCRYPTION_KEY: при нажатии Enter генерируется случайное значение; существующее значение не перезаписывается; при обновлении должно оставаться неизменным;

• Имя администратора по умолчанию: при нажатии Enter используется admin;

• Пароль администратора по умолчанию: при нажатии Enter генерируется случайный; используется только при первом запуске с пустой базой данных;

• Сетевое уведомление о загрузке модели: если Hugging Face недоступен, укажите KB_HTTP_PROXY / KB_HTTPS_PROXY в .env; реранкер большой, можно установить RERANKER_ENABLED=0, чтобы использовать запасной вариант RRF.

Windows PowerShell

git clone https://github.com/arui-git/ai-engineering-brain.git
Set-Location ai-engineering-brain
.\install.ps1

Если политика выполнения PowerShell блокирует сценарий, выполните в текущем окне:

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1

После установки

Скрипт установки выведет адреса Admin и MCP. Войдите в Admin:

http://<服务器IP>:9001/

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

claude mcp add --transport http aeb \
  http://<服务器IP>:8000/mcp \
  --header "Authorization: Bearer <MCP_KEY>"

Или используйте клиентский сценарий:

./claude/setup-claude.sh http://<服务器IP>:8000 <MCP_KEY>

Проверьте Claude Code:

claude mcp list

Конфигурация

.env не фиксируется в Git. При первой установке записываются некоторые случайные значения; см. шаблон:

cp .env.example .env

Ключевые настройки:

Не фиксируйте следующее:

.env
ADMIN_KEY
API_KEYS
MCP_KEY_ENCRYPTION_KEY
ADMIN_BOOTSTRAP_PASSWORD
MCP Key 明文

Часто используемые команды

Просмотр сервисов:

docker compose ps

Просмотр журналов установки/моделей:

docker compose logs -f kb-mcp
docker compose logs -f gateway
docker compose logs -f admin

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

curl http://127.0.0.1:8000/healthz
curl -I http://127.0.0.1:9001/

Проверка учетных записей базы данных и таблицы MCP-ключей:

docker compose exec -T postgres psql -U aeb -d aeb -c '\dt admin_*'
docker compose exec -T postgres psql -U aeb -d aeb -c '\d mcp_api_keys'

Проверка конфигурации и синтаксиса:

docker compose config --quiet
python3 -m py_compile services/admin/app/*.py services/kb-mcp/app/*.py services/gateway/app/*.py
node --check services/admin/app/static/admin.js
bash -n install.sh claude/setup-claude.sh

Данные и обновление

Данные хранятся в томах Docker:

pg_data       账户、MCP Key 元数据、文档状态
qdrant_data   向量索引
kb_docs       原始文档
model_cache   embedding/reranker 模型
repos         代码仓库数据

Перед обновлением рекомендуется создать резервную копию Postgres и важных документов. Обычное обновление:

git pull
docker compose build
docker compose up -d

Не выполняйте:

docker compose down -v

Эта команда удалит тома данных.

Доступ из локальной сети

Если IP-адрес Docker-хоста в локальной сети 192.168.1.10:

Admin: http://192.168.1.10:9001/
MCP:   http://192.168.1.10:8000/mcp

Сначала проверьте с другой машины:

curl http://192.168.1.10:8000/healthz
curl -I http://192.168.1.10:9001/

В Windows + WSL2 mirrored networking, если внутренний WSL и Windows localhost доступны, но IP-адрес Windows/локальной сети истекает по таймауту, необходимо проверить политику сети WSL mirrored/Hyper-V, публикацию портов Docker Desktop и правила входящих подключений локальной сети. Прослушивание служб проекта и публикация Compose должны оставаться:

0.0.0.0:8000 -> Gateway
0.0.0.0:9001 -> Admin

В производственной среде не следует напрямую открывать HTTP-страницу администрирования в ненадежной сети; рекомендуется использовать VPN, межсетевой экран интрасети или обратный прокси-сервер HTTPS, а также регулярно отзывать/ротировать MCP-ключи.

Текущие ограничения

• code-mcp в настоящее время является каркасом возможностей репозитория кода; полная база метаданных Git и индекс AST еще предстоит дополнить;

• mem-mcp в настоящее время является каркасом уровня памяти; автоматическое извлечение/хуки mem0 еще предстоит дополнить;

• модель реранкера большая, при нестабильной сети может оставаться недоступной, при этом основной поиск будет откатываться к RRF;

• Admin в настоящее время подходит для тестирования в интрасети; для продакшена требуются HTTPS/VPN/межсетевой экран;

• система классификации документов (проект, тип документа, теги) — направление улучшений на следующем этапе.

Содержание

services/kb-mcp/       知识库解析、摄入、检索
services/gateway/      唯一对外 MCP、Bearer 鉴权、工具聚合
services/admin/        Admin 页面、账户和 MCP Key
services/code-mcp/     代码能力骨架
services/mem-mcp/      记忆能力骨架
docs/                  设计、部署、稳定性和项目状态文档
claude/                Claude Code 接入脚本与检索行为规则

Лицензия

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