MCP DingDing Bot

MCP DingDing Bot

site icon
2025.03.14 5
TypeScript钉钉机器人消息通知交流协作
MCP DingDing Bot 是一个用于钉钉机器人API的MCP服务,支持钉钉消息通知和交互功能。核心功能包括发送文本和Markdown格式的消息到钉钉群组。适用于需要集成钉钉消息通知的场景,如团队协作、自动化通知等。
View on GitHub

Overview

基本能力

产品定位

MCP DingDing Bot 是一个用于钉钉机器人API的MCP服务,支持钉钉消息通知和交互功能。

核心功能

  • 消息通知:支持发送文本和Markdown格式的消息到钉钉群组。

适用场景

  • 团队协作中的消息通知
  • 自动化任务完成通知
  • 系统监控告警通知

工具列表

  1. send_text_message
  2. 发送纯文本消息到钉钉群组
  3. 输入参数:

    • text (string): 文本内容
    • atAll (可选 boolean): 是否@所有成员
  4. send_markdown_message

  5. 发送Markdown格式的消息到钉钉群组
  6. 输入参数:
    • title (string): 消息标题
    • text (string): Markdown内容
    • atAll (可选 boolean): 是否@所有成员

常见问题解答

  • 如何获取钉钉机器人Token? 进入群设置 > 群机器人管理,创建自定义机器人并保存webhook URL和secret。

使用教程

使用依赖

  • 需要钉钉群组机器人Token和secret

安装教程

Docker

{
  "mcpServers": {
    "gitlab": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DINGTALK_BOT_ACCESS_TOKEN",
        "-e",
        "DINGTALK_BOT_SECRET",
        "shawyeok/mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // 可选,用于启用了签名验证的机器人
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // 可选,用于启用了签名验证的机器人
      }
    }
  }
}

调试方式

  • 确保环境变量DINGTALK_BOT_ACCESS_TOKEN已正确设置
  • 检查钉钉机器人是否已正确配置

构建

Docker 构建命令:

docker build -t shawyeok/mcp-dingding-bot .

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。