返回市场
钉钉机器人服务器

钉钉机器人服务器

作者:HundunOnline20 星标更新:2025-08-24

项目介绍

🚀 mcp-dingdingbot-server

这是一个 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 算法,结合时间戳和密钥。