MCP Dingdingbot Server

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

MCP サーバーアプリケーションで、钉钉グループロボットにさまざまなタイプのメッセージを送信できます。

English | 中文

🚀 クイックスタート

このアプリケーションは、MCP（メッセージ制御プロトコル）サーバーで、钉钉グループロボットにさまざまなタイプのメッセージを送信できます。テキスト、Markdown、画像、画像付きテキスト、テンプレートカードメッセージの送信や、ファイルのアップロードもサポートしています。

✨ 主な機能

• テキストメッセージ送信機能
• Markdown メッセージ送信機能
• 画像メッセージ送信機能
• 画像付きテキストメッセージ送信機能
• テンプレートカードメッセージ送信機能
• ファイルアップロード機能
• 署名検証によるセキュリティ強化

📦 インストール

手動インストール

# リポジトリをクローンしてビルド
$ git clone https://github.com/HundunOnline/mcp-dingdingbot-server.git
$ cd mcp-dingdingbot-server && make build
$ sudo ln -s $PWD/dist/mcp-dingdingbot-server_xxx_xxxx /usr/local/bin/mcp-dingdingbot-server

# "$PWD/dist/mcp-dingdingbot-server_xxx_xxxx" を実際のバイナリファイル名に置き換えてください

# 事前にコンパイルされたリリースバイナリパッケージをダウンロードして使用することもできます。

📚 ドキュメント

設定

{
  "mcpServers": {
    "mcp-dingdingbot-server": {
      "command": "mcp-dingdingbot-server",
      "env": {
        "DINGDING_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx",
        "DINGDING_BOT_SIGN_KEY": "SECxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

環境変数

• DINGDING_BOT_WEBHOOK_KEY: 钉钉ロボットの webhook キーです。必須項目です。
• DINGDING_BOT_SIGN_KEY: 钉钉ロボットの署名検証に使用する署名キーです。オプションですが、セキュリティ強化のために設定することをおすすめします。

使用方法

• send_text: 钉钉グループにテキストメッセージを送信します。
• send_markdown: 钉钉グループに Markdown メッセージを送信します。
• send_image: 钉钉グループに画像メッセージを送信します。
• send_news: 钉钉グループに画像付きテキストメッセージを送信します。画像付きテキストメッセージには、タイトル、説明、URL、画像 URL が含まれます。
• send_template_card: 钉钉グループにテンプレートカードメッセージを送信します。
• upload_file: ファイルを钉钉にアップロードします。

钉钉ロボット

钉钉グループロボットの設定ガイドは以下を参照してください。 https://open.dingtalk.com/document/robots/custom-robot-access

⚠️ 重要提示

DINGDING_BOT_WEBHOOK_KEY はロボットの webhook キーです。 例えば：
https://oapi.dingtalk.com/robot/send?access_token=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa
"693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa" はあなた自身の DINGDING_BOT_WEBHOOK_KEY です。

⚠️ 重要提示

DINGDING_BOT_SIGN_KEY はセキュリティ強化のための署名キーです。 钉钉ロボットのセキュリティ設定で有効にする場合、リクエストを検証するためにこのキーを提供する必要があります。 署名検証には HMAC-SHA256 アルゴリズムが使用され、タイムスタンプとキーが組み合わされます。