mcp-dingding-bot

Instructions

Implementation Reference

• src/index.ts:52-62 (handler)

  Handler function for the 'send_markdown_message' tool. It invokes dingtalkBot.sendMarkdown and formats success or error response.

  async ({ title, text, atMobiles, atAll }) => {
    const response = await dingtalkBot.sendMarkdown(title, text, atMobiles, atAll);
    if (response.errcode !== 0) {
      return {
        content: [{ type: "text", text: `Failed to send message, code: ${response.errcode}, message: ${response.errmsg}` }],
      };
    }
    return {
      content: [{ type: "text", text: "Message sent successfully" }],
    };
  }

• src/index.ts:46-51 (schema)

  Zod input schema defining parameters for send_markdown_message tool: title, text, optional atMobiles and atAll.

  {
    title: z.string().describe("The title of the message"),
    text: z.string().describe("The text content to send"),
    atMobiles: z.array(z.string()).optional().describe("The mobile numbers of users to @mention (ping) individually in the group chat"),
    atAll: z.boolean().optional().describe("Whether to @all the users in the group"),
  },

• src/index.ts:43-63 (registration)

  Registration of the 'send_markdown_message' tool on the MCP server, including name, description, input schema, and handler function.

  server.tool(
    'send_markdown_message',
    'Send a markdown message',
    {
      title: z.string().describe("The title of the message"),
      text: z.string().describe("The text content to send"),
      atMobiles: z.array(z.string()).optional().describe("The mobile numbers of users to @mention (ping) individually in the group chat"),
      atAll: z.boolean().optional().describe("Whether to @all the users in the group"),
    },
    async ({ title, text, atMobiles, atAll }) => {
      const response = await dingtalkBot.sendMarkdown(title, text, atMobiles, atAll);
      if (response.errcode !== 0) {
        return {
          content: [{ type: "text", text: `Failed to send message, code: ${response.errcode}, message: ${response.errmsg}` }],
        };
      }
      return {
        content: [{ type: "text", text: "Message sent successfully" }],
      };
    }
  );

• src/dingtalk_custom_robot.ts:82-108 (helper)

  Core implementation of sending markdown message: constructs MarkdownMessage payload and performs authenticated POST request to DingTalk robot API.

  async sendMarkdown(
    title: string,
    text: string,
    atMobiles?: string[],
    atAll: boolean = false
  ): Promise<MessageResponse> {
    const data: MarkdownMessage = {
      msgtype: 'markdown',
      markdown: {
        title,
        text,
      },
      at: {
        atMobiles: atMobiles || [],
        isAtAll: atAll,
      },
    };
  
    const response = await fetch(this.getSignedUrl(), {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
      },
      body: JSON.stringify(data),
    });
    return response.json() as Promise<MessageResponse>;
  }

• src/dingtalk_custom_robot.ts:41-54 (helper)

  Utility method to generate signed URL for DingTalk API requests using HMAC-SHA256 signature if secret is provided.

  private getSignedUrl(): string {
    const timestamp = Date.now();
  
    if (this.secret) {
      const stringToSign = `${timestamp}\n${this.secret}`;
      const hmac = crypto.createHmac('sha256', this.secret);
      const sign = encodeURIComponent(
        hmac.update(stringToSign).digest('base64')
      );
      return `${this.baseUrl}?access_token=${this.accessToken}×tamp=${timestamp}&sign=${sign}`;
    }
  
    return `${this.baseUrl}?access_token=${this.accessToken}`;
  }