Skip to main content
Glama
genm

MCP Server Discord Webhook

by genm
README.md
# MCP Server Discord Webhook

An MCP server for posting messages to Discord webhooks.

[日本語のREADME](./README.ja.md)

## Installation

```bash
npm install @genpm/mcp-server-discord-webhook
```

## Configuration

Add the following to your MCP configuration file:

```json
{
  "mcpServers": {
    "discord-webhook": {
      "command": "npx",
      "args": [
        "-y",
        "@genpm/mcp-server-discord-webhook"
      ],
      "env": {
        "DISCORD_WEBHOOK_URL": "your-discord-webhook-url"
      },
      "alwaysAllow": [
        "send_message"
      ]
    }
  }
}
```

## Features

### send_message

Sends a message to Discord.

Parameters:
- `content`: Message content (required)
- `username`: Display name (optional)
- `avatar_url`: Avatar URL (optional)

Example:
```typescript
<use_mcp_tool>
<server_name>discord-webhook</server_name>
<tool_name>send_message</tool_name>
<arguments>
{
  "content": "Test message",
  "username": "Custom Name"
}
</arguments>
</use_mcp_tool>
```

## Development

This project uses GitHub Actions for continuous integration and automated publishing to npm. When you push a new version tag (e.g., `v1.0.0`), it will automatically:

1. Build the package
2. Run tests
3. Publish to npm
4. Create a GitHub release

For more details about the release process, see [CHANGELOG.md](./CHANGELOG.md).

## License

MIT

## Author

genm

TDQS

B3.1/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'send_message' has a clear, distinct purpose that cannot be confused with any other tool in the set.

Naming Consistency5/5

Since there is only one tool, naming consistency is inherently perfect. The tool name 'send_message' follows a clear verb_noun pattern, and there are no other tools to create inconsistency.

Tool Count2/5

A single tool is too few for a Discord webhook server, which typically involves operations like sending messages, editing messages, deleting messages, or fetching webhook info. The scope feels incomplete with just one basic action.

Completeness2/5

The tool set is severely incomplete for a Discord webhook domain. It only provides 'send_message', missing essential operations like editing, deleting, or retrieving messages, and lacks any management functions for webhooks themselves.

Maintenance

ActivityInactive
ResponsivenessNo issues