{"_id":"@cloud9-labs/mcp-discord","name":"@cloud9-labs/mcp-discord","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@cloud9-labs/mcp-discord","version":"0.1.0","description":"Discord MCP Server - Interact with Discord API via Model Context Protocol","type":"module","main":"dist/index.js","bin":{"mcp-discord":"dist/index.js"},"scripts":{"build":"tsc","prepare":"npm run build"},"keywords":["mcp","discord","api","bot"],"author":{"name":"Cloud9 Labs"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/cloud9-labs/mcp-discord.git"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","zod":"^3.24.1"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"gitHead":"dbe9b351d94dbf4cb73314fa5c54817c550f59c2","types":"./dist/index.d.ts","_id":"@cloud9-labs/mcp-discord@0.1.0","bugs":{"url":"https://github.com/cloud9-labs/mcp-discord/issues"},"homepage":"https://github.com/cloud9-labs/mcp-discord#readme","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-GcNQK/5XqY3ld5NAHcpIL/1PMH0p/FqAMUpouhBKgM1Ey296KPq/Kg2kvDE14YrhyOQoweFYhfADhPKyz003OQ==","shasum":"cbc41a36971d424046454066d486607d379e4282","tarball":"https://registry.npmjs.org/@cloud9-labs/mcp-discord/-/mcp-discord-0.1.0.tgz","fileCount":25,"unpackedSize":59182,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDSNxy9RJFDYZjIkLhcAaiffJ2ywEo/apNnBX5ox6diaAiEA0QusSOItnh2W9dOP5jTYYxOVH+8COVcw5kcS24G5alI="}]},"_npmUser":{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"},"directories":{},"maintainers":[{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-discord_0.1.0_1770871395055_0.44345247623247586"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-12T04:43:14.982Z","0.1.0":"2026-02-12T04:43:15.241Z","modified":"2026-02-12T04:43:15.453Z"},"maintainers":[{"name":"cloud9.labs","email":"cloud9.ai.labs@gmail.com"}],"description":"Discord MCP Server - Interact with Discord API via Model Context Protocol","homepage":"https://github.com/cloud9-labs/mcp-discord#readme","keywords":["mcp","discord","api","bot"],"repository":{"type":"git","url":"git+https://github.com/cloud9-labs/mcp-discord.git"},"author":{"name":"Cloud9 Labs"},"bugs":{"url":"https://github.com/cloud9-labs/mcp-discord/issues"},"license":"MIT","readme":"# Discord MCP Server\n\nDiscord API integration for Model Context Protocol (MCP). Interact with Discord servers, channels, messages, and users through Claude Desktop or any MCP client.\n\n## Features\n\n- **12 Discord API Tools** for comprehensive Discord automation\n- **Rate Limiting** (5 requests/second with automatic retry)\n- **Type-Safe** with TypeScript and Zod schemas\n- **Proper MCP SDK Pattern** using `McpServer` and `StdioServerTransport`\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `discord_send_message` | Send a message to a channel |\n| `discord_edit_message` | Edit an existing message |\n| `discord_delete_message` | Delete a message |\n| `discord_get_channel` | Get channel details |\n| `discord_list_guild_channels` | List all channels in a server |\n| `discord_get_channel_messages` | Get message history (up to 100 messages) |\n| `discord_get_guild` | Get server details |\n| `discord_list_guild_members` | List server members (up to 1000) |\n| `discord_get_user` | Get user details |\n| `discord_add_reaction` | Add emoji reaction to a message |\n| `discord_create_channel` | Create a new channel |\n| `discord_search_guild_members` | Search members by username/nickname |\n\n## Setup\n\n### 1. Create a Discord Bot\n\n1. Go to [Discord Developer Portal](https://discord.com/developers/applications)\n2. Click \"New Application\" and give it a name\n3. Go to \"Bot\" section and click \"Add Bot\"\n4. Under \"Token\", click \"Reset Token\" and copy it\n5. Enable these **Privileged Gateway Intents**:\n   - Server Members Intent\n   - Message Content Intent\n6. Go to \"OAuth2 > URL Generator\"\n   - Select scopes: `bot`\n   - Select permissions: `Send Messages`, `Read Message History`, `Manage Channels`, `Add Reactions`\n7. Copy the generated URL and invite the bot to your server\n\n### 2. Configure MCP Server\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"discord\": {\n      \"command\": \"node\",\n      \"args\": [\"/Users/A5O1/書類/AI/mcp-discord/dist/index.js\"],\n      \"env\": {\n        \"DISCORD_BOT_TOKEN\": \"YOUR_BOT_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### 3. Restart Claude Desktop\n\nAfter saving the config, restart Claude Desktop to load the MCP server.\n\n## Usage Examples\n\n### Send a Message\n\n```\nUse discord_send_message to send \"Hello from Claude!\" to channel ID 123456789\n```\n\n### Get Channel Messages\n\n```\nUse discord_get_channel_messages to get the last 10 messages from channel 123456789\n```\n\n### Create a Channel\n\n```\nUse discord_create_channel to create a text channel named \"general-chat\" in guild 987654321\n```\n\n### Search Members\n\n```\nUse discord_search_guild_members to find users named \"john\" in guild 987654321\n```\n\n## Finding Discord IDs\n\n### Channel ID\n- Right-click a channel → Copy Channel ID (requires Developer Mode enabled)\n\n### Guild ID\n- Right-click the server icon → Copy Server ID\n\n### User ID\n- Right-click a user → Copy User ID\n\n### Message ID\n- Right-click a message → Copy Message ID\n\n**Enable Developer Mode**: User Settings → Advanced → Developer Mode\n\n## Rate Limiting\n\nThe client implements token bucket rate limiting:\n- **5 requests per second**\n- Automatic retry on HTTP 429 (rate limit exceeded)\n- Respects `Retry-After` headers from Discord API\n\n## API Reference\n\nAll tools follow Discord API v10 specifications:\nhttps://discord.com/developers/docs/reference\n\n## Development\n\n```bash\n# Build\nnpm run build\n\n# Watch mode\nnpx tsc --watch\n```\n\n## License\n\nMIT\n\n## Repository\n\nhttps://github.com/cloud9-labs/mcp-discord\n","readmeFilename":"README.md","_rev":"1-c731b4b2ea19b16cac622323f7010a6a"}