Mcp Dingdingbot Server

🚀 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 for enhanced security

Installation

Manual Installation

# clone the repo and build
$ git clone https://github.com/HundunOnline/mcp-dingdingbot-server.git
$ cd mcp-dingdingbot-server && make build
$ sudo ln -s $PWD/dist/mcp-dingdingbot-server_xxx_xxxx /usr/local/bin/mcp-dingdingbot-server

# "$PWD/dist/mcp-dingdingbot-server_xxx_xxxx" replace with the actual binary file name

#You can also download and use the pre-compiled release binary package.

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: The webhook key for the DingDing Bot server. This is required.
• DINGDING_BOT_SIGN_KEY: The sign key for DingDing Bot signature verification. This is optional but recommended for enhanced security.

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, a news includes title, description, url, picurl

• send_template_card

Send a template card message to DingDing group

• upload_file

Upload a file to DingDing

Samples

> prompt: 给我在钉钉发送一条文本消息，消息内容为：这是一条测试消息
> prompt: 给我在钉钉发送一条markdown消息，消息内容为：# 这是一条测试 Markdown 消息
> prompt: 给我在钉钉发送一条图文消息，图文标题为：这是一条图文消息，图文描述为：这是一条图文消息，图文链接为：https://github.com/HundunOnline，图文图片为：https://img-blog.csdnimg.cn/fcc22710385e4edabccf2451d5f64a99.jpeg

> Send me a text message on DingDing with the content: This is a test message.
> Send me a Markdown message on DingDing with the content: # This is a test Markdown message
> Send me a graphic message on DingDing with the title: This is a graphic message, the description: This is a graphic message, the link: https://github.com/HundunOnline, and the image: https://img-blog.csdnimg.cn/fcc22710385e4edabccf2451d5f64a99.jpeg

DingDing Robot

DingDing group robot configuration guide can be referred to: https://open.dingtalk.com/document/robots/custom-robot-access

DINGDING_BOT_WEBHOOK_KEY is the robot webhook key
For example： https://oapi.dingtalk.com/robot/send?access_token=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa
"693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa" is your own DINGDING_BOT_WEBHOOK_KEY

DINGDING_BOT_SIGN_KEY is the signature key for enhanced security
When enabled in the DingDing robot security settings, you need to provide this key to authenticate requests. The signature verification uses HMAC-SHA256 algorithm with the timestamp and secret key.

中文

概述

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

功能

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

安装

手动安装

# 克隆仓库并构建
$ git clone https://github.com/HundunOnline/mcp-dingdingbot-server.git
$ cd mcp-dingdingbot-server && make build
$ sudo ln -s $PWD/dist/mcp-dingdingbot-server_xxx_xxxx /usr/local/bin/mcp-dingdingbot-server

# "$PWD/dist/mcp-dingdingbot-server_xxx_xxxx" 替换为实际的二进制文件名

# 您也可以下载并使用预编译的发布二进制包。

配置

`

... View full README on GitHub