Mcp Server Dingtalk

by 1lib

470 downloads
Not rated
GitHub

About

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

Details

Author
1lib
Downloads
470
Categories
Other

- DingTalk bot message sending capabilities
- Multiple message types: text, link, markdown, actionCard, feedCard
- Secure webhook signing with HMAC-SHA256
- Built with Vite for fast development and optimized builds
- TypeScript support with strict type checking

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Mcp Server Dingtalk
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by running npx -y mcp-server-dingtalk. Configure via JSON in your MCP client settings, setting the DINGTALK_BOT_CONFIGS environment variable with an array of bot definitions (name, accessToken, signSecret). The server exposes a single tool dingtalk_bot_send_message to send messages with type-specific parameters.

dingtalk_bot_send_message

send a message to a dingtalk chat via bot name

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp server dingtalk": {
            "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\"}]"
                }
            }
        }
    }
}

McpServers

{
    "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\"}]"
        }
    }
}

Features

- πŸ€– DingTalk bot message sending capabilities
- πŸ“¦ Multiple message types support (text, link, markdown, actionCard, feedCard)
- πŸ” Secure webhook signing with HMAC-SHA256
- ⚑ Built with Vite for fast development and optimized production builds
- 🎯 TypeScript support with strict type checking

Prerequisites

- Node.js 18+
- pnpm (recommended) or npm

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

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.