Architect

Created By

rpurinton6 months ago

A Discord.js app integrated with Model Context Protocol (MCP) server functionality to enable AI-driven Discord server administration and automation.

# nodejs

# devops

Overview Content Tools Comments

Content

Architect

Architect is a modular, AI-empowered Discord.js bot designed for automated Discord server administration and management using the Model Context Protocol (MCP).

Features

Discord bot with dynamic slash command support and event handling.
Integrated MCP server exposing Discord admin functions as MCP tools.
AI-driven natural language automation leveraging OpenAI.
Localization with multi-language support.
Robust error handling and graceful shutdown.
Uses Redis caching and MySQL persistence.
Secure MCP HTTP interface with bearer token authentication.
Production-ready with systemd service template.

Quick Start

Clone the repo:

git clone https://github.com/rpurinton/architect.git
cd architect

Install dependencies:
```
npm install
```

Copy and configure environment variables:

cp .env.example .env
# Edit .env to set tokens, DB, Redis credentials etc.

Run:
```
node architect.mjs
```

Configuration

Edit .env file to include your Discord bot token, client ID, database credentials, MCP token, and logging preferences.

Variable	Description	Example
DISCORD_TOKEN	Discord bot token	abc123xyz
DISCORD_CLIENT_ID	Discord application client ID	123456789
DB_HOST	MySQL host	localhost
DB_USER	MySQL username	root
DB_PASS	MySQL password	secret
DB_NAME	MySQL database name	architect_db
REDIS_HOST	Redis cluster host	127.0.0.1
REDIS_PORT	Redis port	6379
MCP_TOKEN	Bearer token for MCP HTTP auth	secret-token
MCP_PORT	MCP HTTP server port	9232
LOG_LEVEL	Logging level (info, debug)	info

Project Structure

/opt/architect
  [39m[0m[39m  [0m[39m[0m[39m├── architect.mjs          # Main app entry point[0m
  [39m  [0m[39m  [0m[39m[0m[39m├── src/[0m
  [39m  [0m[39m  [0m[39m[0m[39m│   [0m[39m[0m[39m├── commands/          # JSON command definitions and handlers[0m
  [39m  [0m[39m  [0m[39m[0m[39m│   [0m[39m[0m[39m├── events/            # Event handlers for Discord.js[0m
  [39m  [0m[39m  [0m[39m[0m[39m│   [0m[39m[0m[39m├── custom/            # MCP server, client, and tools[0m
  [39m  [0m[39m  [0m[39m[0m[39m│   [0m[39m[0m[39m├── locales/           # Localization JSON[0m
  [39m  [0m[39m  [0m[39m[0m[39m│   [0m[39m[0m[39m├── log.mjs            # Logger setup[0m
  [39m  [0m[39m  [0m[39m[0m[39m├── exceptions.mjs     # Global exception handlers[0m
  [39m  [0m[39m  [0m[39m[0m[39m├── shutdown.mjs       # Graceful shutdown handling[0m
  [39m  [0m[39m  [0m[39m[0m[39m└── discord.mjs        # Discord client creation[0m
[39m  [0m[39m[0m[0m[39m[0m[39m[0m[39m[0m[39m  [0m
.env                   # Environment variables
architect.service      # systemd service file
└── docs/              # Developer documentation