钉钉机器人消息服务

一个MCP服务器应用,支持向钉钉群机器人发送多种类型的消息,包括文本、Markdown、图片、图文和模板卡片消息,以及文件上传功能。

  • by HundunOnline
  • Go
  • 本地部署
  • 24 星标
  • 更新于
在 GitHub 查看 HundunOnline/mcp-dingdingbot-server

使用说明

🚀 mcp-dingbot服务器

一个MCP服务器应用程序,向丁丁组机器人发送各种类型的消息。

英语 | 中文

英语

概述

这是一个MCP(消息控制协议)服务器应用程序,允许您向丁丁组机器人发送各种类型的消息。它支持文本、标记、图像、新闻和模板卡片消息,以及文件上传。

特性

  • 短信支持
  • Markdown消息支持
  • 图像消息支持
  • 新闻消息支持
  • 模板卡消息支持
  • 文件上传支持
  • 签名验证以增强安全性

安装

手动安装

# clone the repo and build
$ 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" replace with the actual binary file name

#You can also download and use the pre-compiled release binary package.

配置

{
  "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服务器的webhook密钥。这是必需的。
  • DINGDING_BOT_SIGN_KEY:丁丁机器人签名验证的签名密钥。这是可选的,但建议用于增强安全性。

用法

  • send_text

向鼎鼎群发送短信

  • send_markdown

向鼎鼎集团发送降价消息

  • send_image

向鼎鼎群发送图片消息

  • send_news

向鼎鼎集团发送新闻消息,新闻包括标题、描述、网址、图片网址

  • send_template_card

向鼎鼎集团发送模板卡片消息

  • 上传文件

将文件上传到DingDing

样品


> prompt: 给我在钉钉发送一条文本消息,消息内容为:这是一条测试消息
> prompt: 给我在钉钉发送一条markdown消息,消息内容为:# 这是一条测试 Markdown 消息
> prompt: 给我在钉钉发送一条图文消息,图文标题为:这是一条图文消息,图文描述为:这是一条图文消息,图文链接为:https://github.com/HundunOnline,图文图片为:https://gips2.baidu.com/it/u=1502376378,1119109542&fm=3081&app=3081&f=JPEG?w=2560&h=1688

> Send me a text message on DingDing with the content: This is a test message.
> Send me a Markdown message on DingDing with the content: # This is a test Markdown message
> Send me a graphic message on DingDing with the title: This is a graphic message, the description: This is a graphic message, the link: https://github.com/HundunOnline, and the image: https://gips2.baidu.com/it/u=1502376378,1119109542&fm=3081&app=3081&f=JPEG?w=2560&h=1688


鼎鼎机器人

鼎鼎集团机器人配置指南可参考: 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是增强安全性的签名密钥
在DingDing机器人安全设置中启用时,您需要提供此密钥来验证请求。 签名验证使用带有时间戳和密钥的HMAC-SHA256算法。

中文

概述

这是一个 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

向钉钉群组发送模板卡片消息

  • 上传文件

上传文件到钉钉

钉钉机器人

钉钉群机器人配置指南可参考: 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_SIGN_KEY 是用于增强安全性的签名密钥
当在钉钉机器人安全设置中启用时,您需要提供此密钥来验证请求。 签名验证使用 HMAC-SHA256 算法,结合时间戳和密钥。