MCP 服务器

mcp-dingdingbot-server

钉钉 Webhook MCP 服务器 (Dīngdīng Webhook MCP fúwùqì)

通信

Category.go

访问服务器

README

🚀 mcp-dingdingbot-server

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

English | 中文

中文

概述

这是一个 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" 替换为实际的二进制文件名

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

配置

{
  "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

上传文件到钉钉

钉钉机器人

钉钉群机器人配置指南可参考： https://open.dingtalk.com/document/robots/custom-robot-access

DINGDING_BOT_WEBHOOK_KEY 是机器人的 webhook 密钥<br>例如： https://oapi.dingtalk.com/robot/send?access_token=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa <br> "693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa" 是您自己的 DINGDING_BOT_WEBHOOK_KEY

DINGDING_BOT_SIGN_KEY 是用于增强安全性的签名密钥<br> 当在钉钉机器人安全设置中启用时，您需要提供此密钥来验证请求。签名验证使用 HMAC-SHA256 算法，结合时间戳和密钥。