npm - dingtalk-mcp - Versions diffs - 1.1.0 → 1.1.2 - Mend

dingtalk-mcp 1.1.0 → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/README.md +14 -11
package/dingtalk_servicewindow_mcp_server.yaml +146 -0
package/dingtalk_tasks_mcp_server.yaml +1 -10
package/dist/DingTalkMCPServer.js +11 -0
package/dist/utils/messageBuilder.js +54 -0
package/package.json +2 -2

package/README.md CHANGED Viewed

@@ -11,6 +11,7 @@
 - 钉钉签到
 - 钉钉工作通知
 - 钉钉应用管理
+- 钉钉服务窗
 ## 如何使用
 ```json
@@ -36,17 +37,19 @@
 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<br>Todo.Todo.Read            |
-| dingtalk-calendar           | 钉钉日程               |
-| dingtalk-checkin            | 钉钉签到               |
-| dingtalk-notice             | 钉钉工作通知             |
-| dingtalk-app-manage         | 钉钉应用管理             | qyapi_microapp_manage<br>qyapi_get_microapp_list
+| 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 用于发送工作通知

package/dingtalk_servicewindow_mcp_server.yaml ADDED Viewed

@@ -0,0 +1,146 @@
+server:
+  name: dingtalk-service-window
+  version: 1.0.0
+  description: DingTalk ServiceWindow MCP Server with Message Builder
+  securitySchemes:
+    - id: DingTalkAuth
+      type: apiKey
+      in: header
+      name: x-acs-dingtalk-access-token
+# 注意：当前版本的工具定义在代码中，此配置文件为预留扩展
+tools:
+  - name: sendServiceWindowMessage
+    description: "发送服务窗单人消息"
+    requestTemplate:
+      method: POST
+      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:
+      method: POST
+      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: getServiceWindowFollowerInfo
+    description: "获取关注服务窗的单个用户信息"
+    requestTemplate:
+      method: GET
+      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: listServiceWindowFollowersInfo
+    description: "批量获取关注服务窗用户的信息"
+    requestTemplate:
+      method: GET
+      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/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: "获取企业下的服务窗列表，以获取服务窗帐号IDaccountId"
+    requestTemplate:
+      method: GET
+      url: "https://api.dingtalk.com/v1.0/link/accounts"
+      security:
+        id: DingTalkAuth

package/dingtalk_tasks_mcp_server.yaml CHANGED Viewed

@@ -96,16 +96,7 @@ tools:
         position: body
         items:
           type: string
-      - name: detailUrl.appUrl
-        description: 移动端待办详情页URL
-        type: string
-        position: body
-        required: true
-      - name: detailUrl.pcUrl
-        description: PC端待办详情页URL
-        type: string
-        position: body
-        required: true
     requestTemplate:
       url: https://api.dingtalk.com/v1.0/todo/users/{unionId}/tasks
       method: POST

package/dist/DingTalkMCPServer.js CHANGED Viewed

@@ -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 {
@@ -429,6 +432,14 @@ export class DingTalkMCPServer {
         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') {

package/dist/utils/messageBuilder.js ADDED Viewed

@@ -0,0 +1,54 @@
+/**
+ * ServiceWindow Message Builder - 核心特色功能
+ * 简化复杂的服务窗消息格式构建
+ */
+export class ServiceWindowMessageBuilder {
+    /**
+     * 构建服务窗消息体
+     * @param message 用户友好的消息参数
+     * @returns 钉钉API标准格式的消息体
+     */
+    static buildSendServiceWindowMarkdownBody(message) {
+        return {
+            detail: {
+                msgType: "markdown",
+                uuid: this.generateMessageUuid(),
+                userId: message.userId,
+                messageBody: {
+                    markdown: {
+                        title: message.messageTitle,
+                        text: message.messageContent
+                    }
+                }
+            },
+            accountId: message.accountId
+        }
+    }
+    static buildBatchSendServiceWindowMarkdownBody(message) {
+        return {
+            detail: {
+                msgType: "markdown",
+                uuid: this.generateMessageUuid(),
+                userIdList: message.userIdList,
+                messageBody: {
+                    markdown: {
+                        title: message.messageTitle,
+                        text: message.messageContent
+                    }
+                }
+            },
+            accountId: message.accountId
+        }
+    }
+    /**
+     * 生成唯一的消息ID
+     */
+    static generateMessageUuid() {
+        const UUID = crypto.randomUUID();
+        return UUID.toString();
+        // return `msg-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-mcp",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "DingTalk MCP Server - A TypeScript-based MCP server for DingTalk integration",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     "dist/**/*",
     "*.yaml",
     "!dist/test.js",
-    "!dist/utils"
+    "dist/utils"
   ],
   "scripts": {
     "build": "tsc",