Claude Code DingTalk MCP Server

Instructions

Implementation Reference

• src/index.ts:127-152 (registration)

  Registration of the 'dingtalk_send_link' tool in the ListTools handler, including name, description, and input schema.

  {
    name: 'dingtalk_send_link',
    description: 'Send a link message to DingTalk group',
    inputSchema: {
      type: 'object',
      properties: {
        title: {
          type: 'string',
          description: 'Link title',
        },
        text: {
          type: 'string',
          description: 'Link description text',
        },
        messageUrl: {
          type: 'string',
          description: 'Target URL',
        },
        picUrl: {
          type: 'string',
          description: 'Optional image URL',
        },
      },
      required: ['title', 'text', 'messageUrl'],
    },
  },

• src/index.ts:308-324 (handler)

  Main handler function for the dingtalk_send_link tool, called from the switch statement in CallToolRequestSchema handler. Checks client configuration and delegates to DingTalkClient.sendLink.

  private async handleSendLink(args: { title: string; text: string; messageUrl: string; picUrl?: string }) {
    if (!this.dingTalkClient) {
      throw new Error('DingTalk client not configured. Use dingtalk_configure first or set environment variables (DINGTALK_WEBHOOK, DINGTALK_SECRET).');
    }
  
    const success = await this.dingTalkClient.sendLink(args.title, args.text, args.messageUrl, args.picUrl);
    return {
      content: [
        {
          type: 'text',
          text: success 
            ? '✅ Link message sent successfully' 
            : '❌ Failed to send link message',
        },
      ],
    };
  }

• src/dingtalk.ts:85-90 (handler)

  Core implementation of sending a link message in DingTalkClient, constructs the DingTalkMessage object and calls sendMessage.

  async sendLink(title: string, text: string, messageUrl: string, picUrl?: string): Promise<boolean> {
    return this.sendMessage({
      msgtype: 'link',
      link: { title, text, messageUrl, picUrl }
    });
  }

• src/dingtalk.ts:46-67 (helper)

  Generic sendMessage helper in DingTalkClient that handles HTTP POST to webhook with optional signature, used by all message types including link.

  async sendMessage(message: DingTalkMessage): Promise<boolean> {
    try {
      const signParams = this.generateSign();
      const url = signParams 
        ? `${this.config.webhook}&${signParams}`
        : this.config.webhook;
  
      const response = await fetch(url, {
        method: 'POST',
        headers: {
          'Content-Type': 'application/json',
        },
        body: JSON.stringify(message),
      });
  
      const result = await response.json();
      return result.errcode === 0;
    } catch (error) {
      console.error('DingTalk notification failed:', error);
      return false;
    }
  }

• src/dingtalk.ts:18-23 (schema)

  Type definition for link message in DingTalkMessage interface, used to structure the payload for DingTalk API.

  link?: {
    title: string;
    text: string;
    picUrl?: string;
    messageUrl: string;
  };