返回 MCP 目录
public公开dns本地运行

mcp-dingding-bot

一个用于钉钉机器人API的MCP服务器,支持发送文本和Markdown格式的消息通知

article

README

🚀 MCP 钉钉机器人服务器

MCP 钉钉机器人服务器专为钉钉机器人(DingDing Bot API)打造,支持钉钉(Dingtalk)消息通知与交互,为你提供便捷的群聊消息服务。

🚀 快速开始

要使用 MCP 钉钉机器人服务器,你需先完成钉钉机器人令牌的配置,再根据自身需求选择 Docker 或 NPX 方式运行。

✨ 主要特性

  • 消息通知:可发送各种类型的钉钉消息,如文字和 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,以下是调用示例
send_text_message(text="这是一条纯文本消息", atAll=False)

发送 Markdown 消息

# 调用 send_markdown_message 函数发送 Markdown 消息
# 假设存在一个函数名为 send_markdown_message,以下是调用示例
send_markdown_message(title="Markdown 消息标题", text="# 这是一个 Markdown 消息", atAll=True)

📚 详细文档

环境变量

  • DINGTALK_BOT_ACCESS_TOKEN:你的钉钉群机器人访问令牌(必需)。
  • DINGTALK_BOT_SECRET:你的钉钉群机器人签名密钥(可选)。

参考资料

📄 许可证

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

即贴即用配置

MCP 客户端配置生成器

选择客户端,补齐所需环境变量,再复制根据当前 MCP 公开配置生成的完整文件

terminal
data_object

当前条目没有标准 command 或远程 URL,暂时无法安全生成客户端配置

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端