# Discord MCP Server 🤖💬

A lightweight, zero-external-dependency [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for interacting with Discord through AI assistants like Google Antigravity, Claude Desktop, Cursor, and other MCP-compliant clients.

## ✨ Features

- 💬 **Messages**: Read recent chat history, send messages, reply to threads/messages, edit and delete messages.
- 🏢 **Servers & Guilds**: List servers the bot belongs to, inspect member lists, roles, and guild details.
- 📁 **Channels & Categories**: Inspect channels, channel topics, and message metadata.
- 🧵 **Threads**: Create and participate in channel threads.
- 📌 **Pins**: Read, add, and remove pinned messages.
- 👍 **Reactions**: Add and remove reactions with unicode and custom emojis.
- 🚀 **Zero External Dependencies**: Built entirely with Python's standard library (`urllib`, `json`).

---

## 🛠️ Tool Reference

| Tool | Description |
| :--- | :--- |
| `get_me` | Get profile information and status of the authenticated bot user. |
| `list_guilds` | List all Discord servers (guilds) the bot is a member of. |
| `get_guild` | Get details of a guild (members, roles, channels, emojis). |
| `list_channels` | List all channels in a guild. |
| `get_channel` | Get details of a specific channel or thread. |
| `list_messages` | Retrieve recent messages from a channel (supports `limit`, `before`, `after`, `around`). |
| `get_message` | Retrieve a single message by channel ID and message ID. |
| `send_message` | Send text messages, replies (`reply_to_message_id`), or rich embeds to a channel. |
| `edit_message` | Edit messages sent by the bot. |
| `delete_message` | Delete a message in a channel. |
| `add_reaction` | Add emoji reactions to messages. |
| `delete_reaction` | Remove bot reactions from messages. |
| `list_members` | List members of a guild. |
| `get_pinned_messages` | List all pinned messages in a channel. |
| `pin_message` | Pin a message in a channel. |
| `unpin_message` | Unpin a message in a channel. |
| `create_thread` | Create a new thread in a channel or from an existing message. |

---

## 🚀 Quickstart & Configuration

### 1. Prerequisites
- Python 3.10+
- A Discord Bot Token (obtain one from the [Discord Developer Portal](https://discord.com/developers/applications)).
  - Ensure your bot has appropriate permissions (e.g. *Read Messages/View Channels*, *Send Messages*, *Read Message History*, *Add Reactions*, etc.).

### 2. Installation & Running
Clone the repository:
```bash
git clone https://github.com/swaritsoni6-lgtm/discord-mcp-server.git
cd discord-mcp-server
```

Set your token and run:
```bash
export DISCORD_BOT_TOKEN="your-bot-token-here"
python3 server.py
```

---

## ⚙️ Client Configurations

### Antigravity / Gemini CLI (`~/.gemini/config/mcp_config.json`)
```json
{
  "mcpServers": {
    "discord": {
      "command": "python3",
      "args": ["/path/to/discord-mcp-server/server.py"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "discord": {
      "command": "python3",
      "args": ["/path/to/discord-mcp-server/server.py"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here"
      }
    }
  }
}
```

---

## 📄 License

[MIT License](LICENSE)