ai-engineering-brain

Für Claude Code und andere MCP-Agenten: eine unternehmensinterne Engineering-Wissensplattform, die interne Dokumente, Code-Repositories und Langzeitgedächtnis in ein einziges MCP-Gateway integriert und über eine Admin-Seite Dokumente, Konten und MCP-Schlüssel verwaltet.

Derzeit am ausgereiftesten und bereits end-to-end mit Docker verifiziert ist die kb-mcp-Wissensdatenbank-Kette. code-mcp und mem-mcp sind bereits an die einheitliche MCP-Aggregationsschnittstelle angebunden, befinden sich aber noch im Gerüst-/kontinuierlichen Ausbau.

Den vollständigen Implementierungsstatus, Fehlerursachen und Lösungen finden Sie unter: docs/kb-mcp-project-status.md.

Funktionen

• Wissensdatenbank: Import von Markdown, TXT, DOCX; Beibehaltung von Überschriftenebenen, Tabellen, Codeblöcken und Zitaten; Parent-Child-Chunking; Qdrant Dense+Sparse Hybrid-Retrieval, RRF, optionaler Reranker.

• Admin-Verwaltung: EASTCOM-Verwaltungsseite, Dokument-Upload/Wiederholung/Löschung, Bereinigung fehlender Dateidatensätze, Konten-Login und RBAC.

• Kontenbezogene MCP-Schlüssel: Nach dem Login können Konten ihre eigenen MCP-Schlüssel erstellen, anzeigen, kopieren, ein-/ausblenden und widerrufen; vollständige Schlüssel werden verschlüsselt gespeichert und nicht in Logs geschrieben.

• Einheitliches MCP: Clients verbinden sich nur mit einer /mcp-Adresse des Gateways; das Gateway aggregiert die Tools kb_*, code_*, mem_*.

• LAN-Bereitstellung: Die Dienste laufen auf einem Docker-Host, andere Agenten greifen über das LAN auf das Gateway zu.

Related MCP server: MCP Gateway

Architektur

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 管理页面

Externe Clients müssen nur wissen:

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

Interne 8100/8101/8102 müssen nicht für andere Agenten konfiguriert werden.

Tool-Namensgebung

Die Tools im einheitlichen MCP verwenden Dienstpräfixe:

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

Einige Tools von code-mcp und mem-mcp sind derzeit noch Gerüstimplementierungen; sie können später ohne Änderung der Client-Adresse weiter ergänzt werden.

Schnellinstallation

Voraussetzungen

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

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

• Windows: PowerShell, Docker Desktop;

• Falls ein Modell-Download erforderlich ist, benötigt der Host/Container Zugriff auf Hugging Face; wenn keine direkte Verbindung möglich ist, einen HTTP-Proxy bereitstellen.

Linux / macOS

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

Das Installationsskript fragt interaktiv ab:

• MCP_KEY_ENCRYPTION_KEY: Bei direktem Enter wird ein zufälliger Wert generiert; vorhandene Werte werden nicht überschrieben; bei Upgrades muss er unverändert bleiben;

• Admin-Benutzername: Bei direktem Enter Standard admin;

• Admin-Passwort: Bei direktem Enter wird ein zufälliges generiert; wird nur beim ersten Start mit leerer Datenbank verwendet;

• Netzwerkhinweis für Modell-Download: Wenn Hugging Face nicht erreichbar ist, KB_HTTP_PROXY / KB_HTTPS_PROXY in .env eintragen; der Reranker ist groß, RERANKER_ENABLED=0 kann gesetzt werden, um den RRF-Fallback zu verwenden.

Windows PowerShell

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

Wenn die PowerShell-Ausführungsrichtlinie Skripte blockiert, kann im aktuellen Fenster ausgeführt werden:

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

Nach der Installation

Das Installationsskript gibt die Admin- und MCP-Adressen aus. Melden Sie sich bei Admin an:

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

Gehen Sie zur Seite MCP-Schlüssel, um einen kontenbezogenen Schlüssel zu erstellen, und führen Sie dann auf anderen Agenten-Maschinen aus:

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

Oder verwenden Sie das Client-Skript:

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

Claude Code prüfen:

claude mcp list

Konfigurationshinweise

.env wird nicht in Git committet. Bei der Erstinstallation werden einige Zufallswerte geschrieben; Referenzvorlage:

cp .env.example .env

Wichtige Konfigurationen:

Folgendes nicht committen:

.env
ADMIN_KEY
API_KEYS
MCP_KEY_ENCRYPTION_KEY
ADMIN_BOOTSTRAP_PASSWORD
MCP Key 明文

Häufige Befehle

Dienste anzeigen:

docker compose ps

Installations-/Modell-Logs anzeigen:

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

Gesundheitscheck:

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

Datenbankkonten und MCP-Schlüsseltabelle prüfen:

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'

Konfiguration und Syntax validieren:

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

Daten und Upgrades

Daten werden in Docker-Volumes gespeichert:

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

Vor einem Upgrade wird empfohlen, Postgres und wichtige Dokumente zu sichern. Normales Upgrade:

git pull
docker compose build
docker compose up -d

Nicht ausführen:

docker compose down -v

Dieser Befehl löscht Datenvolumes.

LAN-Zugriff

Wenn die LAN-IP des Docker-Hosts 192.168.1.10 ist:

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

Zuerst von anderen Maschinen testen:

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

Unter Windows + WSL2 mirrored networking, wenn WSL-intern und Windows localhost erreichbar sind, aber Windows/LAN-IP Zeitüberschreitung aufweist, müssen die WSL-mirrored/Hyper-V-Netzwerkrichtlinien, die Docker-Desktop-Portveröffentlichung und die LAN-Eingangsregeln überprüft werden. Der Dienst-Listener und die Compose-Veröffentlichung selbst sollten bleiben:

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

In Produktionsumgebungen sollte die HTTP-Verwaltungsseite nicht direkt einem nicht vertrauenswürdigen Netzwerk ausgesetzt werden; es wird empfohlen, VPN, interne Firewall oder HTTPS-Reverse-Proxy zu verwenden und MCP-Schlüssel regelmäßig zu widerrufen/zu rotieren.

Aktuelle Einschränkungen

• code-mcp ist derzeit ein Gerüst für Code-Repository-Fähigkeiten; die vollständige Git-Metadatenbank und der AST-Index müssen noch ergänzt werden;

• mem-mcp ist derzeit ein Gerüst für die Gedächtnisschicht; die automatische Extraktion/Hooks von mem0 müssen noch ergänzt werden;

• Der Reranker ist groß; bei instabilem Netzwerk kann er nicht verfügbar sein; die Kernsuche fällt dann auf RRF zurück;

• Admin ist derzeit für interne Tests geeignet; in Produktion sind HTTPS/VPN/Firewall erforderlich;

• Das Dokumentklassifizierungssystem (Projekt, Dokumenttyp, Tags) ist eine Erweiterung für die nächste Phase.

Verzeichnis

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

Lizenz

Das aktuelle Repository hat noch keine offizielle Open-Source-Lizenz deklariert. Für eine öffentliche Verteilung fügen Sie bitte vor der Veröffentlichung eine LICENSE-Datei hinzu und klären Sie die Nutzungsrechte für Drittanbietermodelle, Abhängigkeiten und Dokumente.