English Français العربية

Discord MCP

السجل الرسمي الذكاء الاصطناعي والوكلاء

Caller-owned Discord operations for AI agents with 222 typed tools and verifiable guild builds.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @discord-mcp/cli
Claude Code 
claude mcp add discord-mcp -e 'DISCORD_TOKEN=<your discord_token>' -e 'DISCORD_EXPECTED_BOT_ID=<DISCORD_EXPECTED_BOT_ID>' -e 'ALLOWED_GUILDS=<ALLOWED_GUILDS>' -- npx -y @discord-mcp/cli@0.32.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "discord-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@discord-mcp/cli@0.32.1"
            ],
            "env": {
                "DISCORD_TOKEN": "<your discord_token>",
                "DISCORD_EXPECTED_BOT_ID": "<DISCORD_EXPECTED_BOT_ID>",
                "ALLOWED_GUILDS": "<ALLOWED_GUILDS>"
            }
        }
    }
}

متغيرات البيئة

  • DISCORD_TOKEN إلزامي سري Discord bot token. The optional Bot prefix is accepted.
  • DISCORD_EXPECTED_BOT_ID Expected Discord bot ID. Startup fails if the token belongs to another bot.
  • ALLOWED_GUILDS Comma-separated Discord guild IDs this deployment may operate against.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

Discord MCP

An open-source Model Context Protocol (MCP) server for Discord. Connect Claude, Codex, Cursor, and other MCP-compatible AI clients to your own Discord bot. Manage messages, channels, roles, moderation, and server setup through 222 typed tools.

Watch an AI agent build a gaming community: channels, roles, onboarding, AutoMod, and final verification. Play the 87-second video · Download MP4.

You want to…Discord MCP provides
Run a communityMessages, threads, forums, roles, events, polls, and onboarding
Moderate a serverPermission checks, role audits, bans, and AutoMod
Build a server from a promptA blueprint to preview and approve, resumable execution, and final Discord readback
Extend your botSlash commands, interactions, webhooks, and application emojis
Improve an existing serverPreview bounded edits, inspect member access, preserve IDs, resume, and restore selected configuration changes
Read a conversation with sourcesGather bounded channel/thread history and replies with Discord citations and explicit coverage
Run a background workflowStart a durable sequence, inspect progress, cancel cooperatively, and resume after reviewing checkpoints

For a complete server build, Get a verified result: review the plan, approve it, then inspect Activity Evidence from the final readback.

Requires Node.js 22.12+ and your own Discord bot installed in a server you control. Works on Windows, macOS, and Linux.

npm install -g @discord-mcp/cli

Set the bot token in your terminal:

# macOS / Linux
export DISCORD_TOKEN="Bot YOUR_DISCORD_BOT_TOKEN"
# Windows PowerShell
$env:DISCORD_TOKEN = "Bot YOUR_DISCORD_BOT_TOKEN"

Generate a client configuration and verify the connection (Codex example):

discord-mcp setup --profile devbot --client codex
discord-mcp doctor --profile devbot --online
discord-mcp smoke --profile devbot

setup verifies your bot, selects a server boundary, and saves a non-secret profile. Apply the generated configuration to your AI client; setup does not edit it for you. Launch the client with DISCORD_TOKEN available in its environment. The smoke check above does not change Discord.

See client setup for Claude, Codex, Cursor, VS Code/GitHub Copilot, Windsurf, Cline, Roo Code, Continue, Zed, OpenCode, Devin Local, and other clients, plus desktop-app token setup. New to MCP? Get started with the complete tutorial.

  • Your bot, your permissions. Guild and tool-category allowlists constrain access. Keep bot tokens out of client config files and source control.
  • Preview first. Guided setup defaults to MCP_WRITE_MODE=preview, which blocks all mutations. Direct serve defaults to allowing ordinary writes; MCP_DRY_RUN covers only confirmation-gated destructive tools. See safety controls before enabling writes.
  • Local by default. Run over stdio, or self-host a bearer-protected Streamable HTTP endpoint behind HTTPS. See remote MCP setup.

Next stepGuide
Find a tool or workflowTool reference · Recipes
Configure and operateConfiguration · CLI commands
Build or migrate a serverBlueprint workflow · Migration guides
Improve an existing serverChange plans and member access
Read conversations or run background workCited context · Durable workflows
Build an integrationArchitecture · @discord-mcp/core

Inspect the tool catalog without a bot token

discord-mcp catalog --check
discord-mcp catalog --check --json

Validates the real local MCP catalog with no token, no Discord or other network request, and no Discord write. This is not Activity Evidence and does not verify a live connection. Continue with setup to use your bot. See the catalog contract for JSON output. The Docker image defaults to catalog-only mode; bot operations require serve and your own credentials.

Pre-1.0. Check releases and v1.0 readiness for current stability commitments.

Ask questions in Discussions, share a voluntary outcome report, or follow the external documentation review and submit feedback. Never include a bot token, client configuration, private Discord data, or unredacted logs. Report vulnerabilities privately.

To develop locally, run pnpm install, pnpm build, then pnpm test. See Contributing; use MCP Inspector to inspect tool discovery.

Licensed under Apache-2.0. Earlier releases retain their included licenses. The Acceptable Use Policy governs community participation and support without changing the software license.

الأسئلة الشائعة

ما هو Discord MCP؟

Caller-owned Discord operations for AI agents with 222 typed tools and verifiable guild builds.

كيف أثبّت Discord MCP؟

يعمل على جهازك. في Claude Code: claude mcp add discord-mcp -e 'DISCORD_TOKEN=<your discord_token>' -e 'DISCORD_EXPECTED_BOT_ID=<DISCORD_EXPECTED_BOT_ID>' -e 'ALLOWED_GUILDS=<ALLOWED_GUILDS>' -- npx -y @discord-mcp/cli@0.32.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Discord MCP إلى مفتاح API؟

نعم. يتطلب DISCORD_TOKEN، وتضبطها في إعداداته.

هل Discord MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون Discord MCP؟

ينشره cappyeo. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.