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

DingDing Bot

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

article

README

🚀 钉钉机器人 MCP 服务器

钉钉机器人 MCP 服务器专为钉钉机器人 API 打造,支持钉钉消息的通知与交互,能有效提升消息传递的效率与便捷性。

🚀 快速开始

本服务器用于钉钉机器人 API,支持钉钉消息通知和交互。你可以按照以下步骤进行配置和使用。

✨ 主要特性

  • 消息通知:可发送多种类型的钉钉消息,如文本消息和 Markdown 消息。

💻 使用示例

工具介绍

send_text_message

  • 功能:向钉钉群发送纯文本消息。
  • 输入参数
    • text (字符串):文本内容。
    • atAll (可选布尔值):是否 @ 所有成员。

send_markdown_message

  • 功能:发送 Markdown 格式化消息到钉钉群。
  • 输入参数
    • title (字符串):消息标题。
    • text (字符串):Markdown 内容。
    • atAll (可选布尔值):是否 @ 所有成员。

📦 安装指南

钉钉机器人令牌配置

  1. 创建钉钉群聊机器人:
  • 进入群组设置 > 群机器人管理。
  • 创建自定义机器人。
  • 保存 webhook URL 和密钥。

与 Claude Desktop 配合使用

在你的 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 镜像:

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

🔧 技术细节

环境变量说明

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

📚 详细文档

参考资料

📄 许可证

此 MCP 服务器根据 MIT License 分发。你可以自由使用、修改和分发软件,但需遵守 MIT License 的条款和条件。更多细节,请参见项目仓库中的 LICENSE 文件。

help

运行方式说明

cloud

托管运行

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

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

本地运行 / 其它方式

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

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