MCP 服务器

Discord Webhook MCP

Enables LLMs to send messages and rich embeds to Discord via webhooks, supporting plain text messages, formatted embeds with images and fields, and customizable webhook appearance for AI-powered Discord notifications and integrations.

README

<div align="center"> <h1>Discord Webhook MCP</h1> <p>Model Context Protocol server for Discord Webhooks</p> </div>

<div align="center"> <h2>Overview</h2> </div>

Enables LLMs to send messages and rich embeds to Discord via webhooks. Built with TypeScript and the official MCP SDK, it provides a simple, type-safe interface for sending plain text messages, formatted embeds with images and fields, and customizing webhook appearance. Perfect for AI-powered Discord notifications, monitoring, and integrations.

</div>

<div align="center"> <h2>Core Features</h2> </div>

<div align="center"> <table> <tr> <th>Feature</th> <th>Description</th> <th>Use Case</th> </tr> <tr> <td>Simple Messages</td> <td>Send plain text messages up to 2000 characters</td> <td>Quick notifications, status updates</td> </tr> <tr> <td>Rich Embeds</td> <td>Beautiful formatted messages with titles, descriptions, colors, images</td> <td>Structured data, announcements, alerts</td> </tr> <tr> <td>Custom Fields</td> <td>Add up to 25 name-value pairs with inline or block layout</td> <td>Data tables, metrics, lists</td> </tr> <tr> <td>Images & Thumbnails</td> <td>Attach images and thumbnails to embeds</td> <td>Visual content, branding</td> </tr> <tr> <td>Timestamps</td> <td>Automatic or custom timestamps on embeds</td> <td>Event tracking, logs</td> </tr> <tr> <td>Customization</td> <td>Override webhook username and avatar per message</td> <td>Multi-bot appearance, personalization</td> </tr> <tr> <td>Validation</td> <td>Comprehensive input validation and error handling</td> <td>Reliability, debugging</td> </tr> </table> </div>

<div align="center"> <h2>MCP Tools</h2> </div>

The server exposes three tools through the Model Context Protocol interface.

</div>

<div align="center"> <table> <tr> <th>Tool</th> <th>Description</th> <th>Required Parameters</th> </tr> <tr> <td><code>send_message</code></td> <td>Send a simple text message to Discord</td> <td>content</td> </tr> <tr> <td><code>send_embed</code></td> <td>Send a rich embed with title, description, colors, images, and more</td> <td>None (at least one embed field required)</td> </tr> <tr> <td><code>send_embed_with_fields</code></td> <td>Send an embed with custom fields for structured data display</td> <td>fields</td> </tr> </table> </div>

<div align="center"> <h2>Tool Parameters</h2> </div>

send_message

</div>

<div align="center"> <table> <tr> <th>Parameter</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> <tr> <td>content</td> <td>string</td> <td>Yes</td> <td>Message content (max 2000 characters)</td> </tr> <tr> <td>username</td> <td>string</td> <td>No</td> <td>Override webhook username</td> </tr> <tr> <td>avatar_url</td> <td>string</td> <td>No</td> <td>Override webhook avatar URL</td> </tr> </table> </div>

send_embed

</div>

<div align="center"> <table> <tr> <th>Parameter</th> <th>Type</th> <th>Description</th> </tr> <tr> <td>content</td> <td>string</td> <td>Optional message content above the embed</td> </tr> <tr> <td>title</td> <td>string</td> <td>Embed title (max 256 characters)</td> </tr> <tr> <td>description</td> <td>string</td> <td>Embed description (max 4096 characters)</td> </tr> <tr> <td>url</td> <td>string</td> <td>URL that the title will link to</td> </tr> <tr> <td>color</td> <td>string</td> <td>Color as hex (#FF0000), named (red, blue, green, yellow, orange, purple, pink, blurple), or decimal</td> </tr> <tr> <td>timestamp</td> <td>boolean</td> <td>Add current timestamp to embed</td> </tr> <tr> <td>footer_text</td> <td>string</td> <td>Footer text (max 2048 characters)</td> </tr> <tr> <td>footer_icon</td> <td>string</td> <td>Footer icon URL</td> </tr> <tr> <td>image_url</td> <td>string</td> <td>Large image URL displayed in embed</td> </tr> <tr> <td>thumbnail_url</td> <td>string</td> <td>Small thumbnail URL (top right)</td> </tr> <tr> <td>author_name</td> <td>string</td> <td>Author name (max 256 characters)</td> </tr> <tr> <td>author_url</td> <td>string</td> <td>Author URL (makes name clickable)</td> </tr> <tr> <td>author_icon</td> <td>string</td> <td>Author icon URL</td> </tr> <tr> <td>username</td> <td>string</td> <td>Override webhook username</td> </tr> <tr> <td>avatar_url</td> <td>string</td> <td>Override webhook avatar URL</td> </tr> </table> </div>

send_embed_with_fields

</div>

<div align="center"> <table> <tr> <th>Parameter</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> <tr> <td>fields</td> <td>array</td> <td>Yes</td> <td>Array of field objects (max 25 fields)</td> </tr> <tr> <td colspan="4"><em>Each field object contains:</em></td> </tr> <tr> <td>- name</td> <td>string</td> <td>Yes</td> <td>Field name (max 256 characters)</td> </tr> <tr> <td>- value</td> <td>string</td> <td>Yes</td> <td>Field value (max 1024 characters)</td> </tr> <tr> <td>- inline</td> <td>boolean</td> <td>No</td> <td>Display inline (default: false)</td> </tr> <tr> <td colspan="4"><em>All send_embed parameters are also supported</em></td> </tr> </table> </div>

<div align="center"> <h2>Embed Colors</h2> </div>

<div align="center"> <table> <tr> <th>Format</th> <th>Example</th> <th>Result</th> </tr> <tr> <td>Hex</td> <td>#FF0000</td> <td>Red</td> </tr> <tr> <td>Named</td> <td>red, blue, green, yellow, orange, purple, pink, blurple, white, black, gray</td> <td>Predefined colors</td> </tr> <tr> <td>Decimal</td> <td>16711680</td> <td>Red</td> </tr> </table> </div>

<div align="center"> <h2>Discord Limits</h2> </div>

<div align="center"> <table> <tr> <th>Item</th> <th>Maximum</th> </tr> <tr> <td>Message content</td> <td>2000 characters</td> </tr> <tr> <td>Embed title</td> <td>256 characters</td> </tr> <tr> <td>Embed description</td> <td>4096 characters</td> </tr> <tr> <td>Field name</td> <td>256 characters</td> </tr> <tr> <td>Field value</td> <td>1024 characters</td> </tr> <tr> <td>Footer text</td> <td>2048 characters</td> </tr> <tr> <td>Author name</td> <td>256 characters</td> </tr> <tr> <td>Fields per embed</td> <td>25 fields</td> </tr> <tr> <td>Total embed characters</td> <td>6000 characters</td> </tr> <tr> <td>Embeds per message</td> <td>10 embeds</td> </tr> <tr> <td>Webhook rate limit</td> <td>30 requests/minute</td> </tr> </table> </div>

<div align="center"> <h2>Installation</h2> </div>

<div align="center"> <table> <tr> <th>Step</th> <th>Instructions</th> </tr> <tr> <td><strong>Prerequisites</strong></td> <td> Node.js 18.0.0 or higher<br> A Discord webhook URL </td> </tr> <tr> <td><strong>Getting Webhook URL</strong></td> <td> 1. Open your Discord server<br> 2. Go to Server Settings → Integrations → Webhooks<br> 3. Click "New Webhook" or select an existing one<br> 4. Copy the webhook URL<br> 5. The URL format should be: <code>https://discord.com/api/webhooks/{id}/{token}</code> </td> </tr> <tr> <td><strong>Install Dependencies</strong></td> <td><code>npm install</code></td> </tr> <tr> <td><strong>Configure Environment</strong></td> <td> Create a <code>.env</code> file in the project root:<br> <code>DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN</code> </td> </tr> <tr> <td><strong>Build the Project</strong></td> <td><code>npm run build</code></td> </tr> </table> </div>

<div align="center"> <h2>Configuration</h2> </div>

Claude Desktop

</div>

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "discord-webhook": {
      "command": "node",
      "args": ["/path/to/discord-webhook-mcp/dist/index.js"],
      "env": {
        "DISCORD_WEBHOOK_URL": "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"
      }
    }
  }
}

Other MCP Clients

</div>

The server runs on stdio transport and can be used with any MCP-compatible client. Ensure the DISCORD_WEBHOOK_URL environment variable is set.

<div align="center"> <h2>Development</h2> </div>

Project Structure

</div>

<div align="center"> <table> <tr> <th>Directory</th> <th>Description</th> </tr> <tr> <td>src/discord/</td> <td>Discord API integration (webhook client, embed builder, types)</td> </tr> <tr> <td>src/tools/</td> <td>MCP tool implementations (send-message, send-embed, send-embed-fields)</td> </tr> <tr> <td>src/utils/</td> <td>Utility functions (environment validation, custom errors)</td> </tr> <tr> <td>src/index.ts</td> <td>Main MCP server entry point</td> </tr> <tr> <td>tests/</td> <td>Comprehensive test suite with 80%+ coverage</td> </tr> </table> </div>

Development Commands

</div>

<div align="center"> <table> <tr> <th>Command</th> <th>Description</th> </tr> <tr> <td><code>npm install</code></td> <td>Install dependencies</td> </tr> <tr> <td><code>npm run dev</code></td> <td>Run in development mode</td> </tr> <tr> <td><code>npm run watch</code></td> <td>Watch for changes</td> </tr> <tr> <td><code>npm run build</code></td> <td>Build for production</td> </tr> <tr> <td><code>npm test</code></td> <td>Run tests</td> </tr> <tr> <td><code>npm run test:watch</code></td> <td>Run tests in watch mode</td> </tr> <tr> <td><code>npm run test:coverage</code></td> <td>Generate coverage report</td> </tr> <tr> <td><code>npm run typecheck</code></td> <td>Type check</td> </tr> <tr> <td><code>npm run lint</code></td> <td>Lint code</td> </tr> <tr> <td><code>npm run lint:fix</code></td> <td>Fix lint issues</td> </tr> </table> </div>

Discord Webhook MCP

README

推荐服务器