DingDing Bot

Envia vários tipos de mensagens, incluindo texto, markdown, imagens e arquivos, para um robô de grupo do DingDing.

Documentação

🚀 mcp-dingdingbot-server

Um aplicativo de servidor MCP que envia vários tipos de mensagens para o robô de grupo DingDing.

Inglês | Chinês

Inglês

Visão Geral

Este é um aplicativo de servidor MCP (Message Control Protocol) que permite enviar vários tipos de mensagens para robôs de grupo DingDing. Ele suporta mensagens de texto, markdown, imagem, notícias e cartão de modelo, além de upload de arquivos.

Recursos

  • Suporte a mensagens de texto
  • Suporte a mensagens Markdown
  • Suporte a mensagens de imagem
  • Suporte a mensagens de notícias
  • Suporte a mensagens de cartão de modelo
  • Suporte a upload de arquivos
  • Verificação de assinatura para maior segurança

Instalação

Instalação Manual

# 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.

Configuração

{
  "mcpServers": {
    "mcp-dingdingbot-server": {
      "command": "mcp-dingdingbot-server",
      "env": {
        "DINGDING_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "DINGDING_BOT_SIGN_KEY": "SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Variáveis de Ambiente

  • DINGDING_BOT_WEBHOOK_KEY: A chave webhook para o servidor DingDing Bot. Isso é obrigatório.
  • DINGDING_BOT_SIGN_KEY: A chave de assinatura para verificação de assinatura do DingDing Bot. Isso é opcional, mas recomendado para maior segurança.

Uso

  • send_text

Envia uma mensagem de texto para o grupo DingDing

  • send_markdown

Envia uma mensagem markdown para o grupo DingDing

  • send_image

Envia uma mensagem de imagem para o grupo DingDing

  • send_news

Envia uma mensagem de notícias para o grupo DingDing, uma notícia inclui título, descrição, url, picurl

  • send_template_card

Envia uma mensagem de cartão de modelo para o grupo DingDing

  • upload_file

Envia um arquivo para o DingDing

Exemplos


> prompt: 给我在钉钉发送一条文本消息,消息内容为:这是一条测试消息
> prompt: 给我在钉钉发送一条markdown消息,消息内容为:# 这是一条测试 Markdown 消息
> prompt: 给我在钉钉发送一条图文消息,图文标题为:这是一条图文消息,图文描述为:这是一条图文消息,图文链接为:https://github.com/HundunOnline,图文图片为:https://img-blog.csdnimg.cn/fcc22710385e4edabccf2451d5f64a99.jpeg

> 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://img-blog.csdnimg.cn/fcc22710385e4edabccf2451d5f64a99.jpeg


Robô DingDing

O guia de configuração do robô de grupo DingDing pode ser consultado em:

https://open.dingtalk.com/document/robots/custom-robot-access

DINGDING_BOT_WEBHOOK_KEY é a chave webhook do robô
Por exemplo: https://oapi.dingtalk.com/robot/send?access_token=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa
"693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa" é a sua própria DINGDING_BOT_WEBHOOK_KEY

DINGDING_BOT_SIGN_KEY é a chave de assinatura para maior segurança
Quando habilitado nas configurações de segurança do robô DingDing, você precisa fornecer esta chave para autenticar solicitações. A verificação de assinatura usa o algoritmo HMAC-SHA256 com o timestamp e a chave secreta.

Chinês

Visão Geral

Este é um aplicativo de servidor MCP (Message Control Protocol) que permite enviar vários tipos de mensagens para robôs de grupo DingDing. Ele suporta mensagens de texto, Markdown, imagem, notícias e cartão de modelo, além de upload de arquivos.

Recursos

  • Suporte a mensagens de texto
  • Suporte a mensagens Markdown
  • Suporte a mensagens de imagem
  • Suporte a mensagens de notícias
  • Suporte a mensagens de cartão de modelo
  • Suporte a upload de arquivos
  • Verificação de assinatura para maior segurança

Instalação

Instalação Manual

# 克隆仓库并构建
$ 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" 替换为实际的二进制文件名

# 您也可以下载并使用预编译的发布二进制包。

Configuração

{
  "mcpServers": {
    "mcp-dingdingbot-server": {
      "command": "mcp-dingdingbot-server",
      "env": {
        "DINGDING_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "DINGDING_BOT_SIGN_KEY": "SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Variáveis de Ambiente

  • DINGDING_BOT_WEBHOOK_KEY: A chave webhook do robô DingDing. Isso é obrigatório.
  • DINGDING_BOT_SIGN_KEY: A chave de assinatura para verificação de assinatura do robô DingDing. Isso é opcional, mas recomendado para maior segurança.

Uso

  • send_text

Envia uma mensagem de texto para o grupo DingDing

  • send_markdown

Envia uma mensagem markdown para o grupo DingDing

  • send_image

Envia uma mensagem de imagem para o grupo DingDing

  • send_news

Envia uma mensagem de notícias para o grupo DingDing, uma notícia inclui título, descrição, URL e URL da imagem

  • send_template_card

Envia uma mensagem de cartão de modelo para o grupo DingDing

  • upload_file

Envia um arquivo para o DingDing

Robô DingDing

O guia de configuração do robô de grupo DingDing pode ser consultado em:

https://open.dingtalk.com/document/robots/custom-robot-access

DINGDING_BOT_WEBHOOK_KEY é a chave webhook do robô
Por exemplo: https://oapi.dingtalk.com/robot/send?access_token=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa
"693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa" é a sua própria DINGDING_BOT_WEBHOOK_KEY

DINGDING_BOT_SIGN_KEY é a chave de assinatura para maior segurança
Quando habilitado nas configurações de segurança do robô DingDing, você precisa fornecer esta chave para autenticar solicitações. A verificação de assinatura usa o algoritmo HMAC-SHA256, combinando timestamp e chave secreta.