Dingding Bot

🚀 釘釘機器人 MCP 服務器

釘釘機器人 MCP 服務器專為釘釘機器人 API 打造，支持釘釘及釘talk 的消息通知與交互功能，能有效滿足各類消息通知需求。

🚀 快速開始

MCP 服務器用於釘釘機器人 API，支持釘釘 / 釘talk 消息通知和交互。你可以按照以下步驟進行配置和使用。

✨ 主要特性

• 消息通知：可發送多種類型的釘釘消息，包括文本和 Markdown 格式。

📦 安裝指南

釘釘機器人令牌

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 build -t shawyeok/mcp-dingding-bot .

💻 使用示例

基礎用法

本服務器提供了兩個實用工具來發送不同類型的消息。

send_text_message

向釘釘群發送純文本消息。

# 該工具可向釘釘群發送純文本消息
# 輸入參數：
# text (字符串)：文本內容
# atAll (可選布爾值)：是否 @ 所有成員

send_markdown_message

發送 Markdown 格式化消息到釘釘群。

# 該工具可發送 Markdown 格式化消息到釘釘群
# 輸入參數：
# title (字符串)：消息標題
# text (字符串)：Markdown 內容
# atAll (可選布爾值)：是否 @ 所有成員

🔧 技術細節

環境變量

• DINGTALK_BOT_ACCESS_TOKEN：你的釘釘群機器人訪問令牌（必填）
• DINGTALK_BOT_SECRET：你的釘釘群機器人簽名密鑰（可選）

📚 詳細文檔

參考資料

• MCP 服務器快速開始
• 釘釘自定義機器人接入文檔

📄 許可證

此 MCP 服務器根據 MIT License 分發。這意味著你可以自由使用、修改和分發軟件，但需遵守 MIT License 的條款和條件。更多細節，請參見項目倉庫中的 LICENSE 文件。