Architect

by rpurinton

330 downloads

Not rated

GitHub

About

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

Details

Author: rpurinton
Downloads: 330
Categories: Other, Infrastructure

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Architect

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "architect": {
            "architect": {
                "command": "node",
                "args": [
                    "architect.mjs"
                ]
            }
        }
    }
}

McpServers

{
    "architect": {
        "command": "node",
        "args": [
            "architect.mjs"
        ]
    }
}

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

1. Clone the repo:

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

2. Install dependencies:

   npm install

3. Copy and configure environment variables:

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

4. 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

License

MIT License

Contact

Russell Purinton at <russell.purinton@gmail.com>

---

Please see docs/ for comprehensive documentation and contribution guidelines.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Architect

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Architect

Features

Quick Start

Configuration

Project Structure

Development

Deployment

Troubleshooting

Support & Resources

License

Contact

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Architect

Features

Quick Start

Configuration

Project Structure

Development

Deployment

Troubleshooting

Support & Resources

License

Contact

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀