MCP Dingding Bot

🚀 MCP DingTalk Bot Server

An MCP server for the DingTalk Bot API, supporting DingTalk message notifications and interactions.

🚀 Quick Start

The MCP DingTalk Bot Server provides an interface to interact with the DingTalk Bot API, enabling seamless message notifications and interactions within DingTalk groups.

✨ Features

• Message Notifications: Send various types of DingTalk messages (text/Markdown).

💻 Usage Examples

Basic Usage

The server offers two main tools for sending messages:

send_text_message

• Function: Send a plain text message to a DingTalk group.
• Inputs:
  • text (string): The content of the text message.
  • atAll (optional boolean): Whether to @ all group members.

send_markdown_message

• Function: Send a Markdown-formatted message to a DingTalk group.
• Inputs:
  • title (string): The title of the message.
  • text (string): The Markdown content.
  • atAll (optional boolean): Whether to @ all group members.

📦 Installation

DingTalk Bot Token

1. Create a DingTalk group chat robot:

• Go to group settings > group robot management.
• Create a custom robot.
• Save the webhook URL and secret key.

Use with Claude Desktop

Add the following content to your claude_desktop_config.json file:

Docker

{
  "mcpServers": {
    "gitlab": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DINGTALK_BOT_ACCESS_TOKEN",
        "-e",
        "DINGTALK_BOT_SECRET",
        "shawyeok/mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // Optional, for robots with signature verification enabled
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // Optional, for robots with signature verification enabled
      }
    }
  }
}

🔧 Technical Details

Build

To build the Docker image, use the following command:

docker build -t shawyeok/mcp-dingding-bot .

Environment Variables

• DINGTALK_BOT_ACCESS_TOKEN: Your DingTalk group bot access token (required).
• DINGTALK_BOT_SECRET: Your DingTalk group bot signature key (optional).

📚 Documentation

• Model Context Protocol Quickstart
• DingTalk Custom Robot Access Documentation

📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more information, please refer to the LICENSE file in the project repository.