Architect

What is Architect?

Architect is a modular, AI-empowered Discord.js bot that automates Discord server administration and management using the Model Context Protocol (MCP). It integrates with OpenAI for natural language understanding, uses Redis caching and MySQL persistence, and exposes Discord admin functions as configurable MCP tools.

How to use Architect?

Clone the repository, install dependencies with npm install, copy and edit .env to set your Discord bot token, client ID, database credentials, MCP token, and logging preferences, then run node architect.mjs. Deploy as a systemd service using the provided template.

Key features of Architect

• Dynamic slash command support and event handling via Discord.js
• Integrated MCP server exposing Discord admin functions as tools
• AI‑driven natural language automation leveraging OpenAI
• Localization with multi‑language support
• Redis caching and MySQL persistence for state and data
• Secure MCP HTTP interface with bearer token authentication
• Robust error handling, graceful shutdown, and production‑ready systemd service

Use cases of Architect

• Automate routine Discord server administration tasks using natural language commands
• Manage roles, channels, and user permissions through MCP‑controlled tools
• Build a custom AI‑assisted moderation and management bot for large Discord communities
• Integrate Discord operations into broader MCP‑based workflows and external applications

FAQ from Architect

What runtime and dependencies does Architect require?

Node.js, a MySQL database, and a Redis instance. The bot also requires a Discord application token and an OpenAI API key for AI features.

How does Architect communicate with external systems?

Architect uses an MCP HTTP interface with bearer token authentication. It also communicates with Discord via Discord.js and with MySQL and Redis through their respective clients.

Where are data and state stored?

Persistent data is stored in MySQL, and session or caching data is stored in Redis.

Can I run Architect as a background service?

Yes. The repository includes a systemd service template (architect.service) for production deployment.

What authentication is used for the MCP interface?

A bearer token specified in the MCP_TOKEN environment variable is required for all MCP HTTP requests.