MCP Dingdingbot Server

🚀 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 算法，结合时间戳和密钥。