Dingding Bot

🚀 钉钉ロボット MCP サーバー

この MCP サーバーは、钉钉ロボット API 用に設計されており、钉钉 / 釘 talk のメッセージ通知とインタラクションをサポートしています。

🚀 クイックスタート

MCP サーバーを使用することで、钉钉ロボットを通じて様々なタイプのメッセージ通知を行うことができます。以下に、基本的な使い方を説明します。

✨ 主な機能

• メッセージ通知：様々なタイプの钉钉メッセージ（テキスト / Markdown）を送信できます。

📦 インストール

钉钉ロボットトークンの設定

1. 钉钉グループチャットロボットを作成します：
   • グループ設定 > グループロボット管理にアクセスします。
   • カスタムロボットを作成します。
   • webhook URL とシークレットを保存します。

環境変数の設定

• DINGTALK_BOT_ACCESS_TOKEN：あなたの钉钉グループロボットのアクセストークン（必須）
• DINGTALK_BOT_SECRET：あなたの钉钉グループロボットの署名キー（オプション）

Docker を使用した設定

claude_desktop_config.json に以下の内容を追加します。

{
  "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 を使用した設定

claude_desktop_config.json に以下の内容を追加します。

{
  "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 .

💻 使用例

基本的な使用法

テキストメッセージの送信

# このコードは、テキストメッセージを钉钉グループに送信するためのものです。
# 具体的な実装は、`send_text_message` 関数を使用します。
# 入力パラメータとして、テキスト内容と @ 全員のフラグを指定できます。

Markdown メッセージの送信

# このコードは、Markdown 形式のメッセージを钉钉グループに送信するためのものです。
# 具体的な実装は、`send_markdown_message` 関数を使用します。
# 入力パラメータとして、メッセージタイトル、Markdown 内容、@ 全員のフラグを指定できます。

高度な使用法

高度なシナリオでは、環境変数や設定ファイルを適切に設定することで、より柔軟な運用が可能です。例えば、署名検証を有効にする場合は、DINGTALK_BOT_SECRET 環境変数を設定します。

📚 ドキュメント

ツールの説明

1. send_text_message

   • 钉钉グループに純粋なテキストメッセージを送信します。
   • 入力パラメータ：
     • text (文字列)：テキスト内容
     • atAll (オプションのブール値)：全員を @ するかどうか

2. send_markdown_message

   • 钉钉グループに Markdown 形式のメッセージを送信します。
   • 入力パラメータ：
     • title (文字列)：メッセージのタイトル
     • text (文字列)：Markdown 内容
     • atAll (オプションのブール値)：全員を @ するかどうか

🔧 技術詳細

この MCP サーバーは、钉钉ロボット API を利用してメッセージ通知を行います。Docker や NPX を使用して簡単に設定でき、環境変数を通じてアクセストークンや署名キーを設定できます。

📄 ライセンス

この MCP サーバーは MIT License に基づいて配布されています。これは、あなたが自由にソフトウェアを使用、変更、配布できることを意味しますが、MIT License の条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。

参考資料

• https://modelcontextprotocol.io/quickstart/server
• https://open.dingtalk.com/document/robots/custom-robot-access