{"id":26304280,"url":"https://github.com/saseq/discord-mcp","last_synced_at":"2025-10-08T20:04:36.947Z","repository":{"id":282476887,"uuid":"948723723","full_name":"SaseQ/discord-mcp","owner":"SaseQ","description":"A MCP server for the Discord integration. Enable your AI assistants to seamlessly interact with Discord. Enhance your Discord experience with powerful automation capabilities.","archived":false,"fork":false,"pushed_at":"2025-08-11T16:36:35.000Z","size":75,"stargazers_count":87,"open_issues_count":1,"forks_count":19,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-08T20:04:36.362Z","etag":null,"topics":["ai","claude","discord","discord-bot","java","mcp","mcp-server","n8n"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SaseQ.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-14T21:00:40.000Z","updated_at":"2025-10-07T15:11:27.000Z","dependencies_parsed_at":"2025-03-14T22:20:28.364Z","dependency_job_id":"326611b4-f106-4107-8c50-823cd32fc52b","html_url":"https://github.com/SaseQ/discord-mcp","commit_stats":null,"previous_names":["saseq/discord-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/SaseQ/discord-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaseQ%2Fdiscord-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaseQ%2Fdiscord-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaseQ%2Fdiscord-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaseQ%2Fdiscord-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SaseQ","download_url":"https://codeload.github.com/SaseQ/discord-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SaseQ%2Fdiscord-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000705,"owners_count":26082819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","discord","discord-bot","java","mcp","mcp-server","n8n"],"created_at":"2025-03-15T08:15:35.012Z","updated_at":"2025-10-08T20:04:36.924Z","avatar_url":"https://github.com/SaseQ.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/img/Discord_MCP_full_logo.svg\" width=\"60%\" alt=\"DeepSeek-V3\" /\u003e\n\u003c/div\u003e\n\u003chr\u003e\n\u003cdiv align=\"center\" style=\"line-height: 1;\"\u003e\n    \u003ca href=\"https://github.com/modelcontextprotocol/servers\" target=\"_blank\" style=\"margin: 2px;\"\u003e\n        \u003cimg alt=\"MCP Server\" src=\"https://badge.mcpx.dev?type=server\" style=\"display: inline-block; vertical-align: middle;\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://smithery.ai/server/@SaseQ/discord-mcp\" target=\"_blank\" style=\"margin: 2px;\"\u003e\n        \u003cimg alt=\"Smithery Badge\" src=\"https://camo.githubusercontent.com/ee5c6c6dc502821f4d57313b2885f7878af52be14142dd98526ea12aedf9b260/68747470733a2f2f736d6974686572792e61692f62616467652f40646d6f6e74676f6d65727934302f646565707365656b2d6d63702d736572766572\" data-canonical-src=\"https://smithery.ai/server/@SaseQ/discord-mcp\" style=\"display: inline-block; vertical-align: middle;\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://discord.gg/5Uvxe5jteM\" target=\"_blank\" style=\"margin: 2px;\"\u003e\n        \u003cimg alt=\"Discord\" src=\"https://img.shields.io/discord/936242526120194108?color=7389D8\u0026label\u0026logo=discord\u0026logoColor=ffffff\" style=\"display: inline-block; vertical-align: middle;\"/\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/SaseQ/discord-mcp/blob/main/LICENSE\" target=\"_blank\" style=\"margin: 2px;\"\u003e\n        \u003cimg alt=\"MIT License\" src=\"https://img.shields.io/github/license/SaseQ/discord-mcp\" style=\"display: inline-block; vertical-align: middle;\"/\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n\n\n## 📖 Description\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) server for the Discord API [(JDA)](https://jda.wiki/), \nallowing seamless integration of Discord Bot with MCP-compatible applications like Claude Desktop.\n\nEnable your AI assistants to seamlessly interact with Discord. Manage channels, send messages, and retrieve server information effortlessly. Enhance your Discord experience with powerful automation capabilities.\n\n\n## 🔬 Installation\n\n### ► 🐳 Docker Installation (Recommended)\n\u003e NOTE: Docker installation is required. Full instructions can be found on [docker.com](https://www.docker.com/products/docker-desktop/).\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"--rm\", \"-i\",\n        \"-e\", \"DISCORD_TOKEN=\u003cYOUR_DISCORD_BOT_TOKEN\u003e\",\n        \"-e\", \"DISCORD_GUILD_ID=\u003cOPTIONAL_DEFAULT_SERVER_ID\u003e\",\n        \"saseq/discord-mcp:latest\"\n      ]\n    }\n  }\n}\n```\n\n\u003cdetails\u003e\n    \u003csummary style=\"font-size: 1.35em; font-weight: bold;\"\u003e\n        🔧 Manual Installation\n    \u003c/summary\u003e\n\n#### Clone the repository\n```bash\ngit clone https://github.com/SaseQ/discord-mcp\n```\n\n#### Build the project\n\u003e NOTE: Maven installation is required to use the mvn command. Full instructions can be found [here](https://www.baeldung.com/install-maven-on-windows-linux-mac).\n```bash\ncd discord-mcp\nmvn clean package # The jar file will be available in the /target directory\n```\n\n#### Configure AI client\nMany code editors and other AI clients use a configuration file to manage MCP servers.\n\nThe Discord MPC server can be configured by adding the following to your configuration file.\n\n\u003e NOTE: You will need to create a Discord Bot token to use this server. Instructions on how to create a Discord Bot token can be found [here](https://discordjs.guide/preparations/setting-up-a-bot-application.html#creating-your-bot).\n```json\n{\n  \"mcpServers\": {\n    \"discord-mcp\": {\n      \"command\": \"java\",\n      \"args\": [\n        \"-jar\",\n        \"/absolute/path/to/discord-mcp-0.0.1-SNAPSHOT.jar\"\n      ],\n      \"env\": {\n        \"DISCORD_TOKEN\": \"YOUR_DISCORD_BOT_TOKEN\",\n        \"DISCORD_GUILD_ID\": \"OPTIONAL_DEFAULT_SERVER_ID\"\n      }\n    }\n  }\n}\n```\nThe `DISCORD_GUILD_ID` environment variable is optional. When provided, it sets a default Discord server ID so any tool that accepts a `guildId` parameter can omit it.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary style=\"font-size: 1.35em; font-weight: bold;\"\u003e\n        ⚓ Smithery Installation\n    \u003c/summary\u003e\n\nInstall Discord MCP Server automatically via [Smithery](https://smithery.ai/):\n```bash\nnpx -y @smithery/cli@latest install @SaseQ/discord-mcp --client \u003cCLIENT_NAME\u003e --key \u003cYOUR_SMITHERY_KEY\u003e\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary style=\"font-size: 1.35em; font-weight: bold;\"\u003e\n        🖲 Cursor Installation\n    \u003c/summary\u003e\n\nGo to: `Settings` -\u003e `Cursor Settings` -\u003e `MCP` -\u003e `Add new global MCP server`\n\nPasting the following configuration into your Cursor `~/.cursor/mcp.json` file is the recommended approach. You may also install in a specific project by creating `.cursor/mcp.json` in your project folder. See [Cursor MCP docs](https://docs.cursor.com/context/model-context-protocol) for more info.\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"--rm\", \"-i\",\n        \"-e\", \"DISCORD_TOKEN=\u003cYOUR_DISCORD_BOT_TOKEN\u003e\",\n        \"-e\", \"DISCORD_GUILD_ID=\u003cOPTIONAL_DEFAULT_SERVER_ID\u003e\",\n        \"saseq/discord-mcp:latest\"\n      ]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n    \u003csummary style=\"font-size: 1.35em; font-weight: bold;\"\u003e\n        ⌨️ Claude Code Installation\n    \u003c/summary\u003e\n\nRun this command. See [Claude Code MCP docs](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/tutorials#set-up-model-context-protocol-mcp) for more info.\n```bash\nclaude mcp add mcp-server -- docker run --rm -i -e DISCORD_TOKEN=\u003cYOUR_DISCORD_BOT_TOKEN\u003e -e DISCORD_GUILD_ID=\u003cOPTIONAL_DEFAULT_SERVER_ID\u003e saseq/discord-mcp:latest\n```\n\n\u003c/details\u003e\n\n## 🛠️ Available Tools\n\n#### Server Information\n - [`get_server_info`](): Get detailed discord server information\n\n#### User Management\n- [`get_user_id_by_name`](): Get a Discord user's ID by username in a guild for ping usage `\u003c@id\u003e`\n- [`send_private_message`](): Send a private message to a specific user\n- [`edit_private_message`](): Edit a private message from a specific user\n- [`delete_private_message`](): Delete a private message from a specific user\n- [`read_private_messages`](): Read recent message history from a specific user\n\n#### Message Management\n - [`send_message`](): Send a message to a specific channel\n - [`edit_message`](): Edit a message from a specific channel\n - [`delete_message`](): Delete a message from a specific channel\n - [`read_messages`](): Read recent message history from a specific channel\n - [`add_reaction`](): Add a reaction (emoji) to a specific message\n - [`remove_reaction`](): Remove a specified reaction (emoji) from a message\n\n#### Channel Management\n - [`create_text_channel`](): Create text a channel\n - [`delete_channel`](): Delete a channel\n - [`find_channel`](): Find a channel type and ID using name and server ID\n - [`list_channels`](): List of all channels\n\n#### Category Management\n - [`create_category`](): Create a new category for channels\n - [`delete_category`](): Delete a category\n - [`find_category`](): Find a category ID using name and server ID\n - [`list_channels_in_category`](): List of channels in a specific category\n\n#### Webhook Management\n - [`create_webhook`](): Create a new webhook on a specific channel\n - [`delete_webhook`](): Delete a webhook\n - [`list_webhooks`](): List of webhooks on a specific channel\n - [`send_webhook_message`](): Send a message via webhook\n\n\u003eIf `DISCORD_GUILD_ID` is set, the `guildId` parameter becomes optional for all tools above.\n\n\u003chr\u003e\n\nA more detailed examples can be found in the [Wiki](https://github.com/SaseQ/discord-mcp/wiki).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaseq%2Fdiscord-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsaseq%2Fdiscord-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsaseq%2Fdiscord-mcp/lists"}