Discord

MCP server for discord bot - adds one tool with raw API access

python

8

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hanweg-mcp-discord-raw": {
      "command": "uv",
      "args": [
        "--directory",
        "PATH/TO/mcp-discord-raw",
        "run",
        "discord-raw-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR-BOT-TOKEN"
      }
    }
  }
}

Discord Raw API MCP Server provides direct access to the Discord REST API and slash command actions through a single, flexible tool. It lets you perform administrative tasks, channel operations, and message interactions from your MCP client with both REST-style calls and slash-command style endpoints.

How to use

You connect to the Discord Raw API MCP Server from your MCP client and issue requests that mirror the Discord API. Use REST-style endpoints to manage resources such as guilds, channels, roles, and messages, or use slash-command style endpoints to perform common actions. The server returns IDs and metadata you can reuse in subsequent requests, enabling chained workflows like creating a role and then assigning it to a member.

How to install

Prerequisites you need before installation:

Node.js (for Smithery-based automatic install)
Python (for manual installation steps, as shown)
A Discord bot with the required intents enabled
A hosting environment that can run Python virtual environments or Node tools

npx -y @smithery/cli install @hanweg/mcp-discord-raw --client claude

Manual installation steps

Follow these steps to run the MCP server locally using Python and a virtual environment.

# Clone the repository
git clone https://github.com/hanweg/mcp-discord-raw.git
cd mcp-discord-raw

# Create and activate a virtual environment
uv venv
.venv\Scripts\activate

# If using Python 3.13+ - install audioop library
uv pip install audioop-lts

# Install the package in editable mode
uv pip install -e .

Configure the MCP client to run the server

Add a runtime configuration that starts the Discord Raw API MCP Server through your client manager. The configuration uses the uv runtime to run the local server from its directory and passes your bot token securely.

"discord-raw": {
      "command": "uv",
      "args": [
        "--directory", 
        "PATH/TO/mcp-discord-raw",
        "run",
        "discord-raw-mcp"
      ],
      "env": {
        "DISCORD_TOKEN": "YOUR-BOT-TOKEN"
      }
    }