📌Overview

Purpose: The primary goal of the MCP DingDingBot Server is to facilitate the sending of different types of messages to DingDing group robots using the Message Control Protocol (MCP).

Overview: The MCP DingDingBot Server is a server application designed to interact with DingDing group robots, allowing users to send various message formats such as text, markdown, images, news articles, and template cards, as well as to upload files.

Key Features:

• Text message support: Enables users to send simple text messages to DingDing groups.

• Markdown message support: Allows sending messages formatted in markdown for richer content presentation.

• Image message support: Provides the capability to send image messages, enhancing visual communication within the group.

• News message support: Facilitates the sending of news articles that can include titles, descriptions, URLs, and images.

• Template card message support: Supports the transmission of structured messages using template cards for better engagement.

• File upload support: Users can upload files directly to DingDing groups for easy sharing.

• Signature verification for enhanced security: Adds a layer of security through optional signature verification, ensuring that messages sent are legitimate.

---

🚀 mcp-dingdingbot-server

An MCP server application that sends various types of messages to the DingDing group robot.

English | 中文

English

Overview

This is an MCP (Message Control Protocol) server application that allows you to send various types of messages to DingDing group robots. It supports text, markdown, image, news, and template card messages, as well as file uploads.

Features

• Text message support
• Markdown message support
• Image message support
• News message support
• Template card message support
• File upload support
• Signature verification

Installation

Manual Installation

# Clone the repo and build
$ git clone https://github.com/HundunOnline/mcp-dingdingbot-server.git
$ cd mcp-dingdingbot-server && make build

Configuration

{
  "mcpServers": {
    "mcp-dingdingbot-server": {
      "command": "mcp-dingdingbot-server",
      "env": {
        "DINGDING_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "DINGDING_BOT_SIGN_KEY": "SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Environment Variables

• DINGDING_BOT_WEBHOOK_KEY: Required webhook key for the DingDing Bot server.
• DINGDING_BOT_SIGN_KEY: Optional signature key for verification.

Usage

• send_text: Send a text message to DingDing group.
• send_markdown: Send a markdown message to DingDing group.
• send_image: Send an image message to DingDing group.
• send_news: Send a news message to DingDing group (includes title, description, URL, PICURL).
• send_template_card: Send a template card message to DingDing group.
• upload_file: Upload a file to DingDing.

DingDing Robot

For configuration guidance for DingDing group robot, refer to DingTalk Documentation.

---

中文

概述

这是一个 MCP（消息控制协议）服务器应用程序，允许您向钉钉群机器人发送各种类型的消息。它支持文本、Markdown、图片、图文和模板卡片消息，以及文件上传。

功能

• 文本消息支持
• Markdown 消息支持
• 图片消息支持
• 图文消息支持
• 模板卡片消息支持
• 文件上传支持
• 签名验证

安装

手动安装

# 克隆仓库并构建
$ git clone https://github.com/HundunOnline/mcp-dingdingbot-server.git
$ cd mcp-dingdingbot-server && make build

配置

{
  "mcpServers": {
    "mcp-dingdingbot-server": {
      "command": "mcp-dingdingbot-server",
      "env": {
        "DINGDING_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "DINGDING_BOT_SIGN_KEY": "SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

环境变量

• DINGDING_BOT_WEBHOOK_KEY: 必需的钉钉机器人的 webhook 密钥。
• DINGDING_BOT_SIGN_KEY: 可选的签名验证密钥。

使用方法

• send_text: 向钉钉群组发送文本消息。
• send_markdown: 向钉钉群组发送 markdown 消息。
• send_image: 向钉钉群组发送图片消息。
• send_news: 向钉钉群组发送图文消息（包括标题、描述、URL 和图片 URL）。
• send_template_card: 向钉钉群组发送模板卡片消息。
• upload_file: 上传文件到钉钉。

钉钉机器人

钉钉群机器人配置指南请参考 钉钉文档.