article
README
🚀 MCP 钉钉机器人服务器
MCP 钉钉机器人服务器专为钉钉机器人(DingDing Bot API)打造,支持钉钉(Dingtalk)消息通知与交互,为你提供便捷的群聊消息服务。
🚀 快速开始
要使用 MCP 钉钉机器人服务器,你需先完成钉钉机器人令牌的配置,再根据自身需求选择 Docker 或 NPX 方式运行。
✨ 主要特性
- 消息通知:可发送各种类型的钉钉消息,如文字和 Markdown 格式的消息。
📦 安装指南
钉钉机器人令牌
- 创建一个钉钉群聊机器人:
- 进入群设置 > 群机器人管理。
- 创建一个自定义机器人。
- 保存网钩 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 文件。
微信扫一扫