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.
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @discord-mcp/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
DISCORD_TOKEN=<secret> DISCORD_EXPECTED_BOT_ID=<value> ALLOWED_GUILDS=<value> claude mcp add io.github.cappyeo-discord-mcp -- npx -y @discord-mcp/cli@0.34.1在終端機中執行。
{ "mcpServers": { "io.github.cappyeo-discord-mcp": { "command": "npx", "args": [ "-y", "@discord-mcp/[email protected]" ], "env": { "DISCORD_TOKEN": "<secret>", "DISCORD_EXPECTED_BOT_ID": "<value>", "ALLOWED_GUILDS": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
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.
Caller-owned Discord operations for AI agents with 222 typed tools and verifiable guild builds.
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.
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.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.
Caller-owned Discord operations for AI agents with 222 typed tools and verifiable guild builds.
{ "mcpServers": { "io.github.cappyeo-discord-mcp": { "command": "npx", "args": [ "-y", "@discord-mcp/[email protected]" ], "env": { "DISCORD_TOKEN": "<secret>", "DISCORD_EXPECTED_BOT_ID": "<value>", "ALLOWED_GUILDS": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:DISCORD_TOKEN, DISCORD_EXPECTED_BOT_ID, ALLOWED_GUILDS。
Discord MCP 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 Caller-owned Discord operations for AI agents with 222 typed tools and verifiable guild builds.