🚀 mcp-dingdingbot-server
2025.03.11
18
Go钉钉机器人消息控制团队协作交流协作
mcp-dingdingbot-server 是一个基于 MCP（消息控制协议）的服务器应用程序，专门用于向钉钉群机器人发送各种类型的消息。它支持文本、Markdown、图片、图文和模板卡片消息，以及文件上传功能，并通过签名验证增强安全性。
View on GitHub
Overview
基本能力
产品定位
mcp-dingdingbot-server 是一个专门用于与钉钉群机器人交互的消息控制协议服务器，旨在通过自动化消息发送提升团队协作效率。
核心功能
- 文本消息支持
- Markdown 消息支持
- 图片消息支持
- 图文消息支持
- 模板卡片消息支持
- 文件上传支持
- 签名验证增强安全性
适用场景
- 团队协作中的自动化通知
- 系统监控告警推送
- 自动化报告生成与发送
- 文件共享与管理
工具列表
- send_text: 发送文本消息到钉钉群
- send_markdown: 发送 Markdown 格式消息到钉钉群
- send_image: 发送图片消息到钉钉群
- send_news: 发送图文消息到钉钉群
- send_template_card: 发送模板卡片消息到钉钉群
- upload_file: 上传文件到钉钉
常见问题解答
- 如何获取 DINGDING_BOT_WEBHOOK_KEY？ 参考钉钉机器人配置指南：https://open.dingtalk.com/document/robots/custom-robot-access
- 签名验证是如何工作的？ 使用 HMAC-SHA256 算法结合时间戳和密钥进行签名验证。
使用教程
使用依赖
确保已安装 Git 和 Make 工具。
安装教程
# 克隆仓库并构建
$ 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和DINGDING_BOT_SIGN_KEY已正确设置。 - 使用
mcp-dingdingbot-server命令测试消息发送功能。
示例
> prompt: 给我在钉钉发送一条文本消息，消息内容为：这是一条测试消息
> prompt: 给我在钉钉发送一条markdown消息，消息内容为：# 这是一条测试 Markdown 消息
> prompt: 给我在钉钉发送一条图文消息，图文标题为：这是一条图文消息，图文描述为：这是一条图文消息，图文链接为：https://github.com/HundunOnline，图文图片为：https://img-blog.csdnimg.cn/fcc22710385e4edabccf2451d5f64a99.jpeg