Skip to content

Stewared/Mongocord

Repository files navigation


Mongocord

Mongocord - A Discord MongoDB Client

A Discord Bot MongoDB client. Designed to function similarly to MongoDB Compass, Mongocord supports managing your local or remote Atlas databases cross-platform entirely from Discord.

Support Server   Donate

Features

  • /find

    • Opens the standard modal with projection, filter, and sort abilities.
    • Results are displayed like MongoDB and can be easily edited.
  • /aggregation create|edit|run|delete|import

    • Saves pipelines globally for all users.
    • Shows a paginated stage editor with edit, enable/disable, move, import, and export controls.
    • Runs the pipeline inside Discord and shows a paginated read-only result view with downloads.
  • /import

    • Import documents in JSON format into Mongo, just like Compass.
  • /database create|rename|delete|list

    • Manage databases
  • /collection create|rename|delete|list

    • Manage collections
  • /config

    • confirmations by default, Mongocord will confirm before editing or deleting.
    • admin_add, admin_remove, and admin_list manage who can use Mongocord.

Demo:

Standard queries
Query results
Editing item
Deleting item
Aggrigation query editor
Aggregation feild editor
Aggregation results
Collection listing
Collection deletion

Examples data shown taken from InfiniMii development database.

Installation & Setup

  1. Create a discord bot account at https://discord.com/developers/applications. Search for tutorials online for this step if needed.

  2. Install dependencies:

npm install
  1. Run the interactive setup:
npm run setup

This walks you through creating env.json and configuring PM2 to start Mongocord to run at boot.

  1. The bot is setup. See this reference list for pm2 commands:
  • Start/restart: npm run pm2:start
  • Stop: npm run pm2:stop
  • Status: npm run pm2:status
  • Logs: pm2 logs mongocord

If you change PM2 process configuration and want it persisted across reboots, run:

pm2 save

About

Mongocord: A MongoDB Client for for Discord. Designed to feel like MongoDB Compass.

Topics

Resources

License

Stars

Watchers

Forks

Contributors