dingtalk-mcp 1.0.15 → 1.1.1

package/README.md

@@ -9,9 +9,9 @@
 - 钉钉待办
 - 钉钉日程
 - 钉钉签到
-- 钉钉服务窗
 - 钉钉工作通知
 - 钉钉应用管理
+- 钉钉服务窗
 
 ## 如何使用
 ```json
@@ -25,7 +25,8 @@
          ],
          "env": {
             "DINGTALK_Client_ID": "your dingtalk client id",
-            "DINGTALK_Client_Secret": "your dingtalk client secret"
+            "DINGTALK_Client_Secret": "your dingtalk client secret",
+           "ACTIVE_PROFILES": "dingtalk-contacts,dingtalk-calendar"
          }
       }
    }
@@ -36,21 +37,22 @@
 2. DINGTALK_Client_Secret
 3. ACTIVE_PROFILES，激活哪些钉钉MCP服务，逗号风格，如果是ALL则激活全部。可选集合
 
-| ProfileId                   | Description   | Permission                      |
-|-----------------------------|---------------|---------------------------------|
-| dingtalk-contacts           | 钉钉通讯录         | 
-| dingtalk-department         | 钉钉部门管理        |
-| dingtalk-robot-send-message | 钉钉机器人发消息/DING |
-| dingtalk-honor              | 钉钉企业文化荣誉      |
-| dingtalk-tasks              | 钉钉待办          | Todo.Todo.Write Todo.Todo.Read  |
-| dingtalk-calendar           | 钉钉日程          |
-| dingtalk-checkin            | 钉钉签到          |
-| dingtalk-servicewindow      | 钉钉服务窗         |
-| dingtalk-notice             | 钉钉工作通知        |
-| dingtalk-app-manage         | 钉钉应用管理        | 
-4. ROBOT_CODE，用于发消息/DING的机器人Code
-5. ROBOT_ACCESS_TOKEN，群自定义机器人ACCESS_TOEKN，用于自定义机器人发消息
+| ProfileId                | Description        | Permission                                      |
+|--------------------------|--------------------|-------------------------------------------------|
+| dingtalk-contacts        | 钉钉通讯录，默认激活         |
+| dingtalk-department      | 钉钉部门管理             |
+| dingtalk-robot-send-message | 钉钉机器人发消息/DING，默认激活 | 需要企业内机器人发送消息权限                |
+| dingtalk-honor           | 钉钉企业文化荣誉           |
+| dingtalk-tasks           | 钉钉待办               | Todo.Todo.Write<br>Todo.Todo.Read               |
+| dingtalk-calendar        | 钉钉日程               |
+| dingtalk-checkin         | 钉钉签到               |
+| dingtalk-notice          | 钉钉工作通知             |
+| dingtalk-app-manage      | 钉钉应用管理             | qyapi_microapp_manage<br>qyapi_get_microapp_list |
+| dingtalk-service-window  | 钉钉服务窗              |                                                 |
 
+4. ROBOT_CODE，用于发消息/DING的机器人Code
+5. ROBOT_ACCESS_TOKEN，群自定义机器人ACCESS_TOKEN，用于自定义机器人发消息
+6. DINGTALK_AGENT_ID 用于发送工作通知
 ### 如何获取钉钉Client ID和Client Secret
 1. [成为钉钉开发者](https://open.dingtalk.com/document/orgapp/obtain-developer-permissions)
 2. [创建应用](https://open.dingtalk.com/document/orgapp/create-an-application)

package/dingtalk_calendar_mcp_server.yaml

@@ -1,5 +1,6 @@
 server:
   name: dingtalk-calendar
+  description: 钉钉日历
   securitySchemes:
     - id: DingTalkAuth
       type: apiKey

package/dingtalk_notice_mcp_server.yaml

@@ -1,16 +1,22 @@
 server:
   name: dingtalk-notice
   version: 1.0.0
-  description: DingTalk Work Notice MCP Server - 钉钉工作通知
+  description: DingTalk Work Notice MCP Server - 钉钉工作通知MCP服务器
 
 tools:
   # 发送工作通知消息
   - name: sendNotice
-    description: 发送工作通知消息，支持3种消息类型：text、link、markdown
+    description: 发送工作通知消息，支持 markdown 消息类型
     requestTemplate:
       method: POST
       url: https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2
     args:
+      - name: agent_id
+        type: number
+        required: true
+        position: body
+        description: 发送消息时使用的微应用的AgentID
+        system: DINGTALK_AGENT_ID
       - name: userid_list
         type: string
         required: false
@@ -26,11 +32,23 @@ tools:
         required: false
         position: body
         description: 是否发送给全员（可选，默认false）
-      - name: msg
-        type: object
+      - name: msg.msgtype
+        not_need_model_transform: true
+        type: string
+        required: true
+        position: body
+        description: markdown消息格式
+        default: markdown
+      - name: msg.markdown.title
+        type: string
+        required: true
+        position: body
+        description: markdown消息标题
+      - name: msg.markdown.text
+        type: string
         required: true
         position: body
-        description: 消息内容，支持text、link、markdown三种类型
+        description: markdown消息内容
 
   # 获取工作通知消息的发送结果
   - name: getSendResult
@@ -39,6 +57,12 @@ tools:
       method: POST
       url: https://oapi.dingtalk.com/topapi/message/corpconversation/getsendresult
     args:
+      - name: agent_id
+        type: number
+        required: true
+        position: body
+        description: 发送消息时使用的微应用的AgentID
+        system: DINGTALK_AGENT_ID
       - name: task_id
         type: number
         required: true
@@ -52,6 +76,12 @@ tools:
       method: POST
       url: https://oapi.dingtalk.com/topapi/message/corpconversation/getsendprogress
     args:
+      - name: agent_id
+        type: number
+        required: true
+        position: body
+        description: 发送消息时使用的微应用的AgentID
+        system: DINGTALK_AGENT_ID
       - name: task_id
         type: number
         required: true
@@ -65,21 +95,15 @@ tools:
       method: POST
       url: https://oapi.dingtalk.com/topapi/message/corpconversation/recall
     args:
+      - name: agent_id
+        type: number
+        required: true
+        position: body
+        description: 发送消息时使用的微应用的AgentID
+        system: DINGTALK_AGENT_ID
       - name: msg_task_id
         type: number
         required: true
         position: body
         description: 要撤回的消息任务ID
 
-  # 获取消息模板（内置功能）
-  - name: getMessageTemplates
-    description: 获取所有支持的消息类型模板和示例，帮助用户快速了解消息格式
-    requestTemplate:
-      method: LOCAL
-      url: local://templates
-    args:
-      - name: msgtype
-        type: string
-        required: false
-        position: query
-        description: 指定消息类型（text、link、markdown），不指定则返回所有类型 

package/dingtalk_robot_im_mcp_server.yaml

@@ -79,11 +79,6 @@ tools:
         description: 会话ID。
         position: body
         required: true
-      - name: coolAppCode
-        type: string
-        description: 群聊酷应用编码。
-        system: COOL_APP_CODE
-        position: body
       - name: msgKey
         type: string
         description: 消息模板key，默认为"sampleMarkdown"。
@@ -93,10 +88,11 @@ tools:
         not_need_model_transform: true
       - name: msgParam
         type: string
-        description: 消息内容，为markdown格式。
+        description: 消息内容，格式为JSON字符串，必须遵循此格式 {"title":"title", "text":"markdown内容"}
         position: body
         required: true
 
+
     requestTemplate:
       url: https://api.dingtalk.com/v1.0/robot/groupMessages/send
       method: POST
@@ -162,7 +158,7 @@ tools:
         not_need_model_transform: true
       - name: msgParam
         type: string
-        description: 消息内容，为markdown格式。
+        description: 消息内容，格式为JSON字符串，必须遵循此格式 {"title":"title", "text":"markdown内容"}
         position: body
         required: true
 

package/dingtalk_servicewindow_mcp_server.yaml

@@ -1,7 +1,7 @@
 server:
-  name: dingtalk-servicewindow
+  name: dingtalk-service-window
   version: 1.0.0
-  description: 钉钉服务窗
+  description: DingTalk ServiceWindow MCP Server with Message Builder
   securitySchemes:
     - id: DingTalkAuth
       type: apiKey
@@ -10,11 +10,6 @@ server:
 
 # 注意：当前版本的工具定义在代码中，此配置文件为预留扩展
 tools:
-  - name: buildServiceWindowMessage
-    description: "构建服务窗消息体，支持文本、链接、markdown、卡片等多种类型"
-    requestTemplate:
-      method: POST
-      url: "internal://message-builder"
       
   - name: sendServiceWindowMessage
     description: "发送服务窗单人消息"
@@ -23,7 +18,30 @@ tools:
       url: "https://api.dingtalk.com/v1.0/crm/officialAccounts/oToMessages/send"
       security:
         id: DingTalkAuth
-        
+    args:
+      - name: userId
+        description: 用户userId
+        type: string
+        required: true
+        position: body
+      - name: accountId
+        description: 服务窗帐号ID
+        type: string
+        required: true
+        position: body
+      - name: messageTitle
+        description: 消息标题
+        type: string
+        required: true
+        position: body
+      - name: messageContent
+        description: markdown格式的消息内容
+        type: string
+        required: true
+        position: body
+
+
+
   - name: batchSendServiceWindowMessage
     description: "批量发送服务窗消息"
     requestTemplate:
@@ -31,79 +49,98 @@ tools:
       url: "https://api.dingtalk.com/v1.0/crm/officialAccounts/oToMessages/batchSend"
       security:
         id: DingTalkAuth
+    args:
+      - name: userIdList
+        description: 用户userId
+        type: array
+        required: false
+        position: body
+        items:
+          type: string
+      - name: accountId
+        description: 服务窗帐号ID
+        type: string
+        required: true
+        position: body
+      - name: messageTitle
+        description: 消息标题
+        type: string
+        required: true
+        position: body
+      - name: messageContent
+        description: markdown格式的消息内容
+        type: string
+        required: true
+        position: body
         
-  - name: getServiceWindowFollower
+  - name: getServiceWindowFollowerInfo
     description: "获取关注服务窗的单个用户信息"
     requestTemplate:
       method: GET
-      url: "https://api.dingtalk.com/v1.0/link/followers/infos"
+      url: "https://api.dingtalk.com/v1.0/link/followers/infos?userId={String}&accountId={String}"
       security:
         id: DingTalkAuth
+    args:
+      - name: accountId
+        description: 服务窗帐号ID
+        type: string
+        required: true
+        position: query
+      - name: userId
+        description: 关注服务窗用户的userId
+        type: string
+        required: true
+        position: query
         
-  - name: listServiceWindowFollowers
-    description: "分页获取关注服务窗的用户列表"
+  - name: listServiceWindowFollowersInfo
+    description: "批量获取关注服务窗用户信息"
     requestTemplate:
       method: GET
-      url: "https://api.dingtalk.com/v1.0/link/followers"
+      url: "https://api.dingtalk.com/v1.0/link/followers?accountId={String}&nextToken={String}&maxResults={String}"
       security:
         id: DingTalkAuth
+    args:
+      - name: accountId
+        description: 服务窗帐号ID
+        type: string
+        required: true
+        position: query
+      - name: nextToken
+        description: 分页游标
+        type: string
+        required: false
+        position: query
+      - name: maxResults
+        description: 每页最大条目数，最大值100
+        type: string
+        required: false
+        position: query
+
         
   - name: getUserFollowStatus
     description: "获取用户的服务窗关注状态"
     requestTemplate:
       method: GET
-      url: "https://api.dingtalk.com/v1.0/link/followers/status"
+      url: "https://api.dingtalk.com/v1.0/link/followers/statuses?accountId={String}&userId={String}"
       security:
         id: DingTalkAuth
+    args:
+      - name: accountId
+        description: 服务窗帐号ID
+        type: string
+        required: true
+        position: query
+      - name: userId
+        description: 关注服务窗用户的userId
+        type: string
+        required: true
+        position: query
+
         
   - name: listServiceWindows
-    description: "获取企业下的服务窗列表"
+    description: "获取企业下的服务窗列表，以获取服务窗accountId"
     requestTemplate:
       method: GET
       url: "https://api.dingtalk.com/v1.0/link/accounts"
       security:
-        id: DingTalkAuth
-
-# 消息类型定义
-messageTypes:
-  text:
-    description: "纯文本消息"
-    maxLength: 500
-    
-  link:
-    description: "链接消息"
-    fields:
-      title:
-        maxLength: 128
-        required: true
-      text:
-        maxLength: 500
-        required: true
-      messageUrl:
-        pattern: "^https?://.+"
-        required: true
-      picUrl:
-        required: true
-        
-  markdown:
-    description: "Markdown格式消息"
-    fields:
-      title:
-        maxLength: 30
-        required: true
-      text:
-        maxLength: 500
-        required: true
-        
-  actionCard:
-    description: "卡片消息"
-    fields:
-      title:
-        maxLength: 30
-        required: true
-      markdown:
-        maxLength: 1000
-        required: true
-      cardType:
-        enum: ["single", "independent"]
-        required: true
+        id: DingTalkAuth

package/dist/DingTalkMCPServer.d.ts

@@ -34,6 +34,7 @@ export declare class DingTalkMCPServer {
     private executeTool;
     private buildUrl;
     private buildHeaders;
+    private processMultiParam;
     private buildBody;
     run(): Promise<void>;
 }

package/dist/DingTalkMCPServer.js

@@ -1,11 +1,14 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { ServiceWindowMessageBuilder } from './utils/messageBuilder.js'
 import axios from 'axios';
 import * as yaml from 'js-yaml';
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import {ifError} from "node:assert";
+import {resolveObjectURL} from "node:buffer";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 export class DingTalkMCPServer {
@@ -319,6 +322,9 @@ export class DingTalkMCPServer {
             };
         }
         catch (error) {
+            if (this.debug){
+                console.log(error)
+            }
             let errorMessage = error.message;
             if (axios.isAxiosError(error) && error.response) {
                 // 如果是token相关错误，清除缓存
@@ -375,7 +381,7 @@ export class DingTalkMCPServer {
             return finalQuery ? `${baseUrl}?${finalQuery}` : baseUrl;
         }
         // 特殊处理oapi.dingtalk.com接口且配置了security（自定义机器人发消息不使用这个），将access_token作为URL参数传递
-        if (url.includes('oapi.dingtalk.com') && tool.requestTemplate.security  && this.accessToken) {
+        if (url.includes('oapi.dingtalk.com') && this.accessToken) {
             const separator = url.includes('?') ? '&' : '?';
             return `${url}${separator}access_token=${encodeURIComponent(this.accessToken)}`;
         }
@@ -396,10 +402,44 @@ export class DingTalkMCPServer {
         }
         return headers;
     }
+
+    processMultiParam(body, name, value){
+        let objParmas = name.split('.');
+        if (objParmas && objParmas.length > 1) {
+            if (objParmas.length == 2){
+                if (!body[objParmas[0]]){
+                    body[objParmas[0]] = {};
+                }
+                body[objParmas[0]][objParmas[1]] = value;
+            }
+            if (objParmas.length == 3){
+                if (!body[objParmas[0]]){
+                    body[objParmas[0]] = {};
+                }
+                if (!body[objParmas[0]][objParmas[1]]){
+                    body[objParmas[0]][objParmas[1]] = {};
+                }
+                body[objParmas[0]][objParmas[1]][objParmas[2]] = value;
+            }
+            return true;
+        } else {
+            body[name] = value;
+        }
+        return false;
+    }
+
     buildBody(tool, args) {
         if (tool.requestTemplate.method === 'GET' || tool.requestTemplate.method === 'DELETE') {
             return undefined;
         }
+
+        if (tool.name === 'sendServiceWindowMessage'){
+            return ServiceWindowMessageBuilder.buildSendServiceWindowMarkdownBody(args);
+        }else if (tool.name === 'batchSendServiceWindowMessage'){
+            return ServiceWindowMessageBuilder.buildBatchSendServiceWindowMarkdownBody(args);
+        }
+
+
         const body = {};
         (tool.args || []).forEach(arg => {
             if (arg.position === 'body') {
@@ -413,7 +453,7 @@ export class DingTalkMCPServer {
                 }
                 // 不需要模型处理，直接取默认值赋值
                 if (arg.not_need_model_transform){
-                    body[arg.name] = arg.default
+                    this.processMultiParam(body, arg.name, arg.default);
                     return;
                 }
 
@@ -422,56 +462,40 @@ export class DingTalkMCPServer {
                     return;
                 }
                 //打平Object类型参数，递归处理
-                let objParmas = arg.name.split('.');
-                if (objParmas && objParmas.length > 1) {
-                    if (objParmas.length == 2){
-                        if (!body[objParmas[0]]){
-                            body[objParmas[0]] = {};
-                        }
-                        body[objParmas[0]][objParmas[1]] = args[arg.name];
-                    }
-                    if (objParmas.length == 3){
-                        if (!body[objParmas[0]]){
-                            body[objParmas[0]] = {};
-                        }
-                        if (!body[objParmas[1]]){
-                            body[objParmas[1]] = {};
-                        }
-                        body[objParmas[0]][objParmas[1]][objParmas[2]] = args[arg.name];
-                    }
-                    return;
-                }
+                this.processMultiParam(body, arg.name, args[arg.name]);
 
-
-                // userIds参数直接传递为数组类型，保证请求体为正确的JSON对象
-                if (arg.name === 'userIds' && Array.isArray(args[arg.name])) {
-                    body[arg.name] = args[arg.name];
-                }
-                // 搜索用户API参数名称转换，从snake_case转为camelCase
-                else if (tool.name === 'searchUser') {
-                    // Convert snake_case to camelCase for the search user API
-                    const camelCaseName = arg.name.replace(/_([a-z])/g, (g) => g[1].toUpperCase());
-                    body[camelCaseName] = args[arg.name];
-                }
-                else {
-                    body[arg.name] = args[arg.name];
-                }
+                // // userIds参数直接传递为数组类型，保证请求体为正确的JSON对象
+                // if (arg.name === 'userIds' && Array.isArray(args[arg.name])) {
+                //     body[arg.name] = args[arg.name];
+                // }
+                // // 搜索用户API参数名称转换，从snake_case转为camelCase
+                // else if (tool.name === 'searchUser') {
+                //     // Convert snake_case to camelCase for the search user API
+                //     const camelCaseName = arg.name.replace(/_([a-z])/g, (g) => g[1].toUpperCase());
+                //     body[camelCaseName] = args[arg.name];
+                // }
+                // else {
+                //     body[arg.name] = args[arg.name];
+                // }
             }
         });
         // 为searchUser/searchDepartment添加默认的分页参数
 
         // 设置默认的offset为0
-        if (body.offset === undefined) {
-            body.offset = 0;
-        }
-        // 设置默认的size为20
-        if (body.size === undefined) {
-            body.size = 20;
+        if (tool.name === 'searchDepartment' || tool.name === 'searchUser'){
+            if (body.offset === undefined) {
+                body.offset = 0;
+            }
+            // 设置默认的size为20
+            if (body.size === undefined) {
+                body.size = 20;
+            }
         }
         console.error(`SearchUser API with params: offset=${body.offset}, size=${body.size}`);
 
         return Object.keys(body).length > 0 ? body : undefined;
     }
+
     async run() {
         const transport = new StdioServerTransport();
         await this.server.connect(transport);

package/dist/cli.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { DingTalkMCPServer } from './DingTalkMCPServer.js';
+import {json} from "node:stream/consumers";
 async function main() {
     // 检查环境变量
     const appId = process.env.DINGTALK_Client_ID;
     const appSecret = process.env.DINGTALK_Client_Secret;
     const accessToken = process.env.DINGTALK_ACCESS_TOKEN;
-    process.env.ACTIVE_PROFILES = 'dingtalk-contacts,dingtalk-department'
+
     // 如果既没有AppKey/Secret也没有AccessToken，显示帮助信息
     if (!accessToken && (!appId || !appSecret)) {
         console.error('🔧 DingTalk MCP Server 配置指南');
@@ -50,6 +51,8 @@ async function main() {
         console.error('');
         process.exit(1);
     }
+
+
 }
 // 处理未捕获的异常
 process.on('uncaughtException', (error) => {

package/dist/index.js

@@ -1,7 +1,7 @@
 /**
  * DingTalk Calendar MCP Server
- *
- * A TypeScript-based MCP server for DingTalk Calendar integration
+
+ * A TypeScript-based MCP server for DingTalk integration
  */
 export { DingTalkMCPServer } from './DingTalkMCPServer.js';
 export * from './types.js';

package/dist/types.js

@@ -1,5 +1,5 @@
 /**
- * DingTalk Calendar MCP Server Type Definitions
+ * DingTalk MCP Server Type Definitions
  */
 export {};
 //# sourceMappingURL=types.js.map