dingtalk-mcp 1.0.3 → 1.0.4

package/dingtalk_robot_im_mcp_server.yaml

@@ -1,13 +1,14 @@
 server:
   name: dingtalk-robot-send-message
   description: 钉钉机器人发消息和DING消息
+  default_active: true
   securitySchemes:
     - id: DingTalkAuth
       type: apiKey
       in: header
       name: x-acs-dingtalk-access-token
 tools:
-  - name: sendDINGByRobot
+  - name: sendDINGMessageByRobot
     description: 机器人发送DING消息
     args:
       - name: robotCode
@@ -43,7 +44,7 @@ tools:
         id: DingTalkAuth
     responseTemplate: {}
 
-  - name: recallDING
+  - name: recallDINGMessage
     description: 机器人发送DING消息
     args:
       - name: robotCode
@@ -66,3 +67,168 @@ tools:
       security:
         id: DingTalkAuth
     responseTemplate: { }
+  - name: sendGroupMessageByRobot
+    description: 机器人发送群消息
+    args:
+      - name: robotCode
+        description: 机器人Code
+        type: string
+        required: true
+        position: body
+        system: ROBOT_CODE
+      - name: openConversationId
+        type: string
+        description: 会话ID。
+        position: body
+        required: true
+      - name: coolAppCode
+        type: string
+        description: 群聊酷应用编码。
+        system: COOL_APP_CODE
+        position: body
+      - name: msgKey
+        type: string
+        description: 消息模板key，默认为"sampleMarkdown"。
+        position: body
+      - name: msgParam
+        type: string
+        description: 消息内容，为markdown格式。
+        position: body
+        required: true
+
+    requestTemplate:
+      url: https://api.dingtalk.com/v1.0/robot/groupMessages/send
+      method: POST
+      headers:
+        - key: Content-Type
+          value: application/json
+      security:
+        id: DingTalkAuth
+    responseTemplate: { }
+
+  - name: recallGroupMessageByRobot
+    description: 撤回机器人发送的群消息
+    args:
+      - name: robotCode
+        description: 机器人Code
+        type: string
+        required: true
+        position: body
+        system: ROBOT_CODE
+      - name: openConversationId
+        type: string
+        description: 会话ID。
+        position: body
+        required: true
+      - name: processQueryKeys
+        type: array
+        description: 要撤回的消息ID列表。
+        position: body
+        required: true
+        items:
+          type: string
+
+    requestTemplate:
+      url: https://api.dingtalk.com/v1.0/robot/groupMessages/recall
+      method: POST
+      headers:
+        - key: Content-Type
+          value: application/json
+      security:
+        id: DingTalkAuth
+    responseTemplate: { }
+
+  - name: batchSendUserMessageByRobot
+    description: 机器人批量给人发送消息
+    args:
+      - name: robotCode
+        description: 机器人Code
+        type: string
+        required: true
+        position: body
+        system: ROBOT_CODE
+      - name: userIds
+        type: array
+        description: 用户userId列表。
+        position: body
+        required: true
+        items:
+          type: string
+      - name: msgKey
+        type: string
+        description: 消息模板key，默认为"sampleMarkdown"。
+        position: body
+      - name: msgParam
+        type: string
+        description: 消息内容，为markdown格式。
+        position: body
+        required: true
+
+    requestTemplate:
+      url: https://api.dingtalk.com/v1.0/robot/oToMessages/batchSend
+      method: POST
+      headers:
+        - key: Content-Type
+          value: application/json
+      security:
+        id: DingTalkAuth
+    responseTemplate: { }
+  - name: batchRecallUserMessageByRobot
+    description: 批量撤回机器人给人发送的消息
+    args:
+      - name: robotCode
+        description: 机器人Code
+        type: string
+        required: true
+        position: body
+        system: ROBOT_CODE
+      - name: processQueryKeys
+        type: array
+        description: 要撤回的消息ID列表。
+        position: body
+        required: true
+        items:
+          type: string
+
+    requestTemplate:
+      url: https://api.dingtalk.com/v1.0/robot/oToMessages/batchRecall
+      method: POST
+      headers:
+        - key: Content-Type
+          value: application/json
+      security:
+        id: DingTalkAuth
+    responseTemplate: { }
+  - name: sendMessageByCustomRobot
+    description: 群自定义机器人发送群消息
+    args:
+      - name: markdown.title
+        type: string
+        description: 消息标题。
+        position: body
+        required: true
+      - name: markdown.text
+        type: string
+        description: 消息内容，markdown格式。
+        position: body
+        required: true
+      - name: at.isAtAll
+        type: boolean
+        default: false
+        description: 是否@所有人。
+        position: body
+      - name: at.atUserIds
+        type: array
+        items:
+          type: string
+        description: 被@的群成员userId。
+        position: body
+
+
+    requestTemplate:
+      url: https://oapi.dingtalk.com/robot/send?access_token={access_token}
+      method: POST
+      headers:
+        - key: Content-Type
+          value: application/json
+    responseTemplate: { }

package/dist/DingTalkMCPServer.js

@@ -348,14 +348,19 @@ export class DingTalkMCPServer {
                     }
                 }
                 else {
-                    queryParams.set(key, value);
+                    // 处理系统参数，如自动化机器人access_token
+                    if (process.env[value]){
+                        queryParams.set(key, process.env[value]);
+                    }else {
+                        queryParams.set(key, value);
+                    }
                 }
             }
             const finalQuery = queryParams.toString();
             return finalQuery ? `${baseUrl}?${finalQuery}` : baseUrl;
         }
-        // 特殊处理oapi.dingtalk.com接口，将access_token作为URL参数传递
-        if (url.includes('oapi.dingtalk.com') && this.accessToken) {
+        // 特殊处理oapi.dingtalk.com接口且配置了security（自定义机器人发消息不使用这个），将access_token作为URL参数传递
+        if (url.includes('oapi.dingtalk.com') && tool.requestTemplate.security  && this.accessToken) {
             const separator = url.includes('?') ? '&' : '?';
             return `${url}${separator}access_token=${encodeURIComponent(this.accessToken)}`;
         }
@@ -366,7 +371,7 @@ export class DingTalkMCPServer {
             'Content-Type': 'application/json'
         };
         // 只有对新版API (api.dingtalk.com) 才添加token到header
-        if (tool.requestTemplate.url && !tool.requestTemplate.url.includes('oapi.dingtalk.com') && this.accessToken) {
+        if (tool.requestTemplate.url && !tool.requestTemplate.url.includes('oapi.dingtalk.com') && tool.requestTemplate.security && this.accessToken) {
             headers['x-acs-dingtalk-access-token'] = this.accessToken;
         }
         if (tool.requestTemplate.headers) {
@@ -385,6 +390,9 @@ export class DingTalkMCPServer {
             if (arg.position === 'body' && args[arg.name] !== undefined) {
                 // 系统参数，从环境变量读取
                 if (arg.system) {
+                    if (!process.env[arg.system]){
+                        throw new Error(`System parameter ${arg.system} is required， please check your environment variables`);
+                    }
                     body[arg.name] = process.env[arg.system];
                     return;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-mcp",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "DingTalk MCP Server - A TypeScript-based MCP server for DingTalk integration",
   "type": "module",
   "main": "dist/index.js",