MCP Dingdingbot Server

🚀 MCP 钉钉机器人服务器

MCP 钉钉机器人服务器是一个强大的应用程序，它基于 MCP（消息控制协议）构建，能让您轻松地向钉钉群机器人发送多种类型的消息，极大提升信息交互的效率。

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

环境变量

使用方法

• 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 密钥，例如：https://oapi.dingtalk.com/robot/send?access_token=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa ，其中 "693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa" 是您自己的 DINGDING_BOT_WEBHOOK_KEY。

⚠️ 重要提示

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