MMCPMarkets
KM

kevinwatt/mcp-webhook

开发工具
30 stars 0 forks 质量 90 趋势 90
Repository Install

mcp webhook

概览

Send messages to any webhook endpoint through Claude, Dive, and other MCP-compatible AI systems. Perfect for notifications, alerts, and automated messaging. - Works with any webhook endpoint - Compatible with Discord, Slack, Mattermost - Custom HTTP POST requests - JSON payload formatting - Custom display name (username) - Avatar URL support - Flexible message content - Easy integration with any platform - Works with Dive Desktop - Claude Desktop compatible - Cursor, VS Code support - Any MCP-compatible LLM - Minimal configuration - Environment variable support - No tracking or analytics - MIT licensed Add the following config to your MCP client: 1. Open Dive Desktop 2. Click 3. Paste the config provided above 4. Click and you're ready! Use the Claude Code CLI to add the webhook MCP server (guide):

README

🪝 mcp-webhook

✨ Features

🚀 Installation

Getting Started

Add the following config to your MCP client:

{
  "mcpServers": {
    "webhook": {
      "command": "npx",
      "args": ["-y", "@kevinwatt/mcp-webhook"],
      "env": {
        "WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

MCP Client Configuration

Installing via Smithery

To install MCP Webhook Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kevinwatt/mcp-webhook --client claude

Manual Installation

npm install -g @kevinwatt/mcp-webhook

🛠️ Available Tools

💡 Usage Examples

Basic Messages

"Send a message to webhook: Hello World!"
"Send 'Build completed successfully' to the webhook"
"Notify the team: Deployment finished"

Custom Username

"Send a message with username 'Deploy Bot': Production update complete"
"Send content='Server restarted', username='System Monitor'"

With Avatar

"Send a message with custom avatar: content='Alert!', avatar_url='https://example.com/alert.png'"

Automation Examples

"Send a webhook message when the build completes"
"Notify via webhook: All tests passed!"
"Send deployment status to the webhook channel"

🔧 Configuration

Environment Variables

Variable Description Required
WEBHOOK_URL The webhook endpoint URL Yes

Example Configurations

Discord Webhook:

{
  "env": {
    "WEBHOOK_URL": "https://discord.com/api/webhooks/..."
  }
}

Slack Incoming Webhook:

{
  "env": {
    "WEBHOOK_URL": "https://hooks.slack.com/services/..."
  }
}

Mattermost Webhook:

{
  "env": {
    "WEBHOOK_URL": "https://your-mattermost.com/hooks/..."
  }
}

🏗️ Architecture

Built With

  • MCP SDK - Model Context Protocol
  • Axios - HTTP client
  • TypeScript - Type safety and developer experience

Key Features

  • ✅ Simple: Minimal setup, just provide a webhook URL
  • ✅ Flexible: Works with any webhook-compatible service
  • ✅ Type-Safe: Full TypeScript support
  • ✅ Lightweight: Minimal dependencies

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Anthropic - For the Model Context Protocol
  • Dive - MCP-compatible AI platform

📚 Related Projects

View this README on GitHub

安装

npx -y @kevinwatt/mcp-webhook

配置

{ "mcpServers": { "webhook": { "command": "npx", "args": ["-y", "@kevinwatt/mcp-webhook"], "env": { "WEBHOOK_URL": "your-webhook-url" } } } }