LABSCO SUMMARY
One job, and no local project to maintain.
Both supported install paths avoid a checkout entirely — uvx pulls the package from the repository, or the container image is pulled on every launch — so the only thing you own is two environment variables. Create the bot and note its token first; that is the step that takes real time.
What it is
A small Python MCP server whose job is sending messages on Discord, wired up through a bot token and a target user id.
What you get
- Message sending on Discord, available to any MCP client
- A zero-checkout install: uvx runs it straight from the GitHub repo
- A published container image, ghcr.io/pycabbage/discord-mcp:latest, pulled fresh on each run
- An inspector command for poking at the server before you wire it into a client
Requirements
A Discord bot token in DISCORD_TOKEN and the target user id in DISCORD_USER_ID, passed in the client's env block. Everything else is handled by uvx or the container image.
Setup effort
One command plus a key — uvx --from git+https://github.com/pycabbage/discord-mcp@main discord-mcp, then supply credentials
USE CASES
Getting pinged when a long job ends
Have the agent message you on Discord at the end of the run instead of leaving a terminal open.
Routing alerts to a bot you already run
Reuse the existing bot's token so messages arrive from an identity your server already recognises.
Checking it works before trusting it
Run the inspector against the server and send one message by hand.
BEFORE YOU INSTALL
What to know first
Requires
- uvx on PATH
- DISCORD_TOKEN in your environment
- DISCORD_USER_ID in your environment
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
{
"mcpServers": {
"discord-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/pycabbage/discord-mcp@main",
"discord-mcp"
],
"env": {
"DISCORD_TOKEN": "<YOUR_DISCORD_TOKEN>",
"DISCORD_USER_ID": "<YOUR_DISCORD_USER_ID>"
}
}
}
}uvx
uvx --from git+https://github.com/pycabbage/discord-mcp@main discord-mcp