ai-engineering-brain

Claude Code や他の MCP Agent 向けの企業内エンジニアリング知識プラットフォーム：内部ドキュメント、コードリポジトリ、長期記憶を単一の MCP Gateway に統合し、Admin ページでドキュメント、アカウント、MCP Key を管理します。

現在最も成熟しており、Docker でのエンドツーエンド検証が完了しているのは kb-mcp ナレッジベースチェーンです。code-mcp と mem-mcp は統合 MCP アグリゲーションインターフェースに接続されていますが、まだスケルトン/継続改善段階にあります。

プロジェクトの完全な実装状況、障害原因と解決方法は docs/kb-mcp-project-status.md を参照してください。

できること

• ナレッジベース：Markdown、TXT、DOCX をインポート。見出し階層、テーブル、コードブロック、引用を保持。親子チャンク分割。Qdrant の dense+sparse ハイブリッド検索、RRF、オプションの reranker。

• Admin 管理：EASTCOM 管理ページ、ドキュメントのアップロード/再試行/削除、欠落ファイルレコードのクリーンアップ、アカウントログインと RBAC。

• アカウント所有の MCP Key：アカウントログイン後に自分の MCP Key を作成、表示、コピー、表示/非表示、失効させることができます。完全な Key は暗号化して保存され、ログには書き込まれません。

• 統合 MCP：クライアントは Gateway の単一の /mcp アドレスのみに接続します。Gateway は kb_*、code_*、mem_* ツールを集約します。

• LAN デプロイ：サービスは 1 台の Docker ホストで実行され、他の Agent は LAN 経由で Gateway にアクセスします。

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 は他の Agent に設定する必要はありません。

ツール命名

統合 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 を押すとランダム生成されます。既存の値は上書きされません。アップグレード時は必ず同じ値を維持してください。

• Admin 初期ユーザー名：そのまま Enter を押すとデフォルトの admin になります。

• Admin 初期パスワード：そのまま Enter を押すとランダム生成されます。空のデータベースでの初回起動時のみ使用されます。

• モデルダウンロードのネットワーク確認：Hugging Face にアクセスできない場合は、.env に KB_HTTP_PROXY / KB_HTTPS_PROXY を設定してください。reranker は大きいため、RERANKER_ENABLED=0 を設定して RRF fallback を使用できます。

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 キー ページでアカウント所有の Key を作成し、他の Agent マシンで以下を実行します：

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 Key テーブルを確認：

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 volumes に保存されます：

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

このコマンドはデータボリュームを削除します。

LAN アクセス

Docker ホストの LAN IP が 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 にはアクセスできるが、Windows/LAN IP がタイムアウトする場合、WSL mirrored/Hyper-V ネットワークポリシー、Docker Desktop のポート公開、LAN のインバウンドルールを確認する必要があります。プロジェクトのサービスリスニングと Compose の公開設定自体は次のように維持してください：

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

本番環境では HTTP 管理ページを信頼できないネットワークに直接公開しないでください。VPN、内部ファイアウォール、または HTTPS リバースプロキシを使用し、MCP Key を定期的に失効/ローテーションすることを推奨します。

現在の制限

• code-mcp は現在コードリポジトリ機能のスケルトンであり、完全な Git メタデータベースと AST インデックスはまだ未実装です。

• mem-mcp は現在メモリ層のスケルトンであり、mem0 の自動抽出/hook はまだ未実装です。

• reranker モデルはサイズが大きく、ネットワークが不安定な場合は unavailable のままになる可能性があります。コア検索は 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

現在のリポジトリは正式なオープンソースライセンスを宣言していません。公開配布する場合は、リリース前に LICENSE ファイルを追加し、サードパーティのモデル、依存関係、ドキュメントの使用権限を明確にしてください。