Dingtalk V2

🚀 DingTalk MCP Server V2

This is an implementation of a DingTalk robot server based on MCP (Model Control Protocol). It provides various functions for interacting with DingTalk, including sending messages, retrieving conversation information, user information, and calendar events.

🚀 Quick Start

This server offers seamless interaction with DingTalk, enabling users to perform a variety of operations such as message sending and data retrieval.

✨ Features

• Send messages to DingTalk conversations
• Retrieve DingTalk conversation information
• Retrieve DingTalk user information
• Query user calendar events
• Support multiple message types (text, Markdown, links, etc.)

📦 Installation

Environment Requirements

• Python 3.10+
• MCP 0.1.0+
• aiohttp 3.9.1+

Environment Variable Configuration

Before use, set the following environment variables:

• DINGTALK_APP_KEY: AppKey of the DingTalk application
• DINGTALK_APP_SECRET: AppSecret of the DingTalk application

Usage in the Claude Client

1. Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "dingding": {
      "command": "sh",
      "args": [
        "-c",
        "docker ps -a | grep mcp-dingding-v2 | awk '{print $1}' | xargs -r docker rm -f > /dev/null 2>&1; docker pull ghcr.io/wllcnm/mcp-dingding-v2:latest > /dev/null 2>&1; docker run -i --rm --name mcp-dingding-v2 -e DINGTALK_APP_KEY=YourAppKey -e DINGTALK_APP_SECRET=YourAppSecret ghcr.io/wllcnm/mcp-dingding-v2:latest"
      ]
    }
  }
}

Local Development

1. Clone the repository:

git clone https://github.com/yourusername/dingtalk-mcp-server.git
cd dingtalk-mcp-server

2. Install dependencies:

pip install -r requirements.txt

3. Configure environment variables and run:

export DINGTALK_APP_KEY=YourAppKey
export DINGTALK_APP_SECRET=YourAppSecret
python server.py

📚 Documentation

API Tools

send_message

• Function: Send a message to a specified conversation.
• Parameters:
  • conversation_id: ID of the target conversation.
  • message: Content of the message to be sent.
  • msg_type: Message type, default is "text".

get_calendar_list

• Function: Retrieve the calendar of a specified user.
• Parameters:
  • userid: User ID.
  • start_time: Start time (Unix timestamp).
  • end_time: End time (Unix timestamp).
  • max_results: Maximum number of results to return, default is 10.

💻 Usage Examples

Basic Usage

In Claude, you can use the tools like this:

{
  "tool": "send_message",
  "arguments": {
    "conversation_id": "YourConversationID",
    "message": "Hello, DingTalk!",
    "msg_type": "text"
  }
}

Advanced Usage

Query calendar example:

{
  "tool": "get_calendar_list",
  "arguments": {
    "userid": "UserID",
    "start_time": 1704067200000,  // 2024-01-01 00:00:00
    "end_time": 1704153600000,    // 2024-01-02 00:00:00
    "max_results": 10
  }
}

⚠️ Important Note

Security

• Keep your DingTalk API credentials secure.
• Do not share configuration files in public.
• It is recommended to use environment variables instead of hard - coding credentials.

Troubleshooting

• Check if the API credentials are correct.
• Ensure a stable network connection.
• Check the logs for detailed error information.

📄 License

MIT