🚀 MCP 钉钉机器人服务器

MCP 钉钉机器人服务器为钉钉机器人（DingDing Bot API）提供支持，可实现钉钉消息的通知与交互，助力高效沟通。

🚀 快速开始

本服务器支持钉钉消息通知和交互，能发送多种类型的消息。使用前需完成相关配置。

✨ 主要特性

• 消息通知：支持发送各种类型的钉钉消息，如文字、Markdown 格式消息。

📦 安装指南

钉钉机器人令牌

1. 创建一个钉钉群聊机器人：
   • 进入群设置 > 群机器人管理。
   • 创建一个自定义机器人。
   • 保存网钩 URL 和密钥。

与Claude桌面一起使用

将以下内容添加到你的claude_desktop_config.json文件中：

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>" // 可选，用于启用签名验证的机器人
      }
    }
  }
}

构建

Docker 构建命令如下：

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

💻 使用示例

基础用法

发送纯文本消息

# 调用 send_text_message 工具向钉钉群发送纯文本消息
# 假设已经有相应的工具函数实现
send_text_message(text="这是一条纯文本消息", atAll=False)

发送 Markdown 消息

# 调用 send_markdown_message 工具向钉钉群发送 Markdown 消息
# 假设已经有相应的工具函数实现
send_markdown_message(title="消息标题", text="# 这是 Markdown 内容", atAll=False)

📚 详细文档

工具介绍

环境变量

🔧 技术细节

本 MCP 服务器基于相关技术构建，通过环境变量配置与钉钉机器人进行交互。使用 Docker 或 NPX 进行部署，可根据不同场景灵活选择。

📄 许可证

该 MCP 服务器根据 MIT License 授权。你可以自由使用、修改和分发软件，但需遵守 MIT License 的条款和条件。了解更多，请参阅项目存储库中的 LICENSE 文件。

🔗 参考资料

• MCP 服务器快速开始
• 钉钉自定义机器人接入文档