MCP Server DingTalk

A Model Context Protocol (MCP) server for DingTalk integration.

Features

• 🤖 DingTalk bot message sending capabilities
• 📦 Multiple message types support (text, link, markdown, actionCard, feedCard)
• 🔐 Secure webhook signing with HMAC-SHA256
• 🎯 TypeScript support with strict type checking

Prerequisites

• Node.js 18+

Usage

{
    "mcp-server-dingtalk": {
        "transport": "stdio",
        "command": "npx",
        "args": [
            "-y",
            "mcp-server-dingtalk"
        ],
        "env": {
            "DINGTALK_BOT_CONFIGS": "[{\"name\": \"your-bot-name\", \"accessToken\": \"your-access-token\", \"signSecret\": \"your-sign-secret\"}]"
        }
    }
}

Environment Variables

| Variable | Description | Required | Default | |----------|-------------|----------|---------| | DINGTALK_BASE_URL | DingTalk API base URL | No | https://oapi.dingtalk.com/robot/send | | DINGTALK_BOT_CONFIGS | JSON array of bot configurations | Yes | [] |

Available Tools

The server provides the following MCP tool:

dingtalk_bot_send_message

Send messages to DingTalk chat groups via configured bots.

Parameters:

• name (string): Bot name for sending messages
• message (object): Message content with type-specific fields
• notify (object): Notification settings for @ mentions

Supported Message Types:

1. Text Message

   {
     "type": "text",
     "content": "Hello, World!"
   }

2. Link Message

   {
     "type": "link",
     "text": "Link description",
     "title": "Link Title",
     "messageUrl": "https://example.com"
   }

3. Markdown Message

   {
     "type": "markdown",
     "title": "Markdown Title",
     "text": "## Markdown Content\n- Item 1\n- Item 2"
   }

4. Action Card Message

   {
     "type": "actionCard",
     "title": "Action Card Title",
     "text": "Action card content",
     "singleTitle": "Read More",
     "singleURL": "https://example.com"
   }

5. Feed Card Message

   {
     "type": "feedCard",
     "links": [
       {
         "title": "Feed Item",
         "messageURL": "https://example.com",
         "picURL": "https://example.com/image.png"
       }
     ]
   }

License

MIT