Network AI Hub - LibreChat Suite

Note: This project was co-authored with Cursor/Codex 5.3.

LibreChat-based web app suite for browser chat with:

• AWS Bedrock model routing
• Multiple MCP servers (streamable HTTP)
• Local non-Docker startup
• Environment-driven configuration

Architecture

• Browser -> LibreChat Web UI (api service)
• LibreChat -> AWS Bedrock
• LibreChat -> MCP servers (remote streamable HTTP)

Prerequisites

• Node.js 20.19+ and npm
• Git
• Local MongoDB (or Atlas connection via MONGO_URI)
• AWS credentials available to LibreChat (env vars in environment.env)
• MCP server endpoints reachable from this host

Quick Start

1. Copy env template:

cp environment.env.example environment.env

2. Generate required secrets:

bash scripts/gen_secrets.sh

3. Edit environment.env:

• BEDROCK_AWS_DEFAULT_REGION
• Bedrock credentials or rely on host credential chain
• BEDROCK_AWS_MODELS (your Bedrock model IDs)
• BEDROCK_INFERENCE_PROFILE_* values if needed
• MCP_API_KEY (used for X-API-Key header on remote MCP servers)
• optional: ports and MCP URLs

4. Edit librechat.yaml MCP entries to match your servers.

5. Setup local LibreChat source + dependencies:

bash scripts/setup_local.sh

6. Start everything (MongoDB + webserver + app):

bash scripts/start_all.sh

7. Open:

• https://localhost:3080 (default start_all.sh mode)

Make Workflow (Recommended)

From project root:

make up

Available commands:

make up          # restart local app stack
make down        # stop local app stack
make status      # check local app stack status

HTTPS local mode (self-signed cert)

No org cert is required. This starts LibreChat on an internal port and exposes TLS via nginx.

bash scripts/start_suite_ssl.sh

Defaults:

• HTTPS: https://localhost:3080
• backend internal: 127.0.0.1:3081

Override ports if needed:

BACKEND_PORT=3181 HTTPS_PROXY_PORT=3443 bash scripts/start_suite_ssl.sh

Stop

bash scripts/stop_suite.sh

Restart

bash scripts/restart_all.sh

Options:

bash scripts/restart_all.sh

Key Files

• environment.env.example - env template
• librechat.yaml - endpoint + MCP config
• scripts/setup_local.sh - clone/install/build LibreChat locally
• scripts/sync_config.sh - sync env/yaml into local LibreChat source
• scripts/start_all.sh - starts MongoDB + app stack
• scripts/restart_all.sh - stop then start all services
• scripts/stop_suite.sh - one-command shutdown
• scripts/gen_secrets.sh - generate JWT/credential keys

Logging

• Default consolidated log file: logs/ai_agent_librechat.log
• Launcher + backend + nginx entries are written to one app-specific file.
• Startup log filtering keeps config JSON blocks compact:
  • Mongo Connection options [omitted JSON]
  • Custom config file loaded [omitted JSON]

Sanity Check

make up
make status
curl -k -i https://localhost:3080/

Expected:

• HTTPS frontend responds on 3080
• MCP servers are initialized in LibreChat startup logs when librechat.yaml points to active remotes

Notes on Reused Concepts

This suite keeps the same concepts from your previous app:

• Browser-first chat UI
• Bedrock-based assistant
• MCP tool execution
• Multiple MCP server support
• Env-first deployment

The UI and orchestration are now handled by LibreChat itself.