npm - dingtalk-mcp - Versions diffs - 1.1.9 → 1.1.10 - Mend

dingtalk-mcp 1.1.9 → 1.1.10

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 (11) hide show

package/README.md +12 -18
package/dingtalk_contacts_mcp_server.yaml +3 -0
package/dingtalk_notable_mcp_server.yaml +404 -0
package/dingtalk_report_mcp_server.yaml +1 -1
package/dist/DingTalkMCPServer.js +79 -55
package/dist/resources/notable-field-property.md +17 -0
package/dist/resources/notable-record-values.md +18 -0
package/dist/utils/DateUtils.js +29 -0
package/dist/utils/file.js +14 -0
package/dist/utils/localTools.js +20 -0
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,7 +1,6 @@
 # 钉钉MCP Server
 ## 🚀 功能特性
 - 钉钉通讯录
 - 钉钉部门管理
@@ -13,8 +12,6 @@
 - 钉钉工作通知
 - 钉钉应用管理
 - 钉钉服务窗
-- 钉钉项目管理
-- 钉钉日志
 ## 如何使用
 ```json
@@ -40,20 +37,18 @@
 2. DINGTALK_Client_Secret
 3. ACTIVE_PROFILES，激活哪些钉钉MCP服务，逗号风格，如果是ALL则激活全部。可选集合
-| ProfileId                   | Description        | Permission                                       |
-|-----------------------------|--------------------|--------------------------------------------------|
-| dingtalk-contacts           | 钉钉通讯录，默认激活         | qyapi_addresslist_search   qyapi_get_member
-| dingtalk-department         | 钉钉部门管理             |qyapi_get_department_list	qyapi_get_department_member
-| dingtalk-robot-send-message | 钉钉机器人发消息/DING，默认激活 | 需要企业内机器人发送消息权限 <br/>Premium.Ding.Write	                                  |
-| dingtalk-honor              | 钉钉企业文化荣誉           |OrgCulture.Honor.Read	OrgCulture.Honor.Read
-| dingtalk-tasks              | 钉钉待办               | Todo.Todo.Write<br>Todo.Todo.Read                |
-| dingtalk-calendar           | 钉钉日程               |Calendar.Event.Write	Calendar.Event.Read	 Calendar.EventSchedule.Read
-| dingtalk-checkin            | 钉钉签到               |qyapi_checkin_read
-| dingtalk-notice             | 钉钉工作通知             |
-| dingtalk-app-manage         | 钉钉应用管理             | qyapi_microapp_manage<br>qyapi_get_microapp_list |
-| dingtalk-service-window     | 钉钉服务窗              |    OfficialAccount.Message.Send	OfficialAccount.Contact.Read	OfficialAccount.Account.Read	                                              |
-| dingtalk-teambition         | 钉钉项目管理             |  Project.Project.Write.All	Project.Project.Read.All	Project.Task.Write.All	Project.Task.Read.All	                                                |
-| dingtalk-report             | 钉钉日志               | qyapi_report_statistics qyapi_report_manage	qyapi_report_query|
+| ProfileId                | Description        | Permission                                      |
+|--------------------------|--------------------|-------------------------------------------------|
+| dingtalk-contacts        | 钉钉通讯录，默认激活         |
+| dingtalk-department      | 钉钉部门管理             |
+| dingtalk-robot-send-message | 钉钉机器人发消息/DING，默认激活 | 需要企业内机器人发送消息权限                |
+| dingtalk-honor           | 钉钉企业文化荣誉           |
+| dingtalk-tasks           | 钉钉待办               | Todo.Todo.WriteTodo.Todo.Read               |
+| dingtalk-calendar        | 钉钉日程               |
+| dingtalk-checkin         | 钉钉签到               |
+| dingtalk-notice          | 钉钉工作通知             |
+| dingtalk-app-manage      | 钉钉应用管理             | qyapi_microapp_manageqyapi_get_microapp_list |
+| dingtalk-service-window  | 钉钉服务窗              |                                                 |
 4. ROBOT_CODE，用于发消息/DING的机器人Code
 5. ROBOT_ACCESS_TOKEN，群自定义机器人ACCESS_TOKEN，用于自定义机器人发消息
@@ -69,7 +64,6 @@
 ## 📞 支持
-- 帮助文档： https://open.dingtalk.com/document/ai-dev/dingtalk-server-api-mcp-overview
 - 钉钉开放平台: https://open.dingtalk.com
 - MCP协议: https://modelcontextprotocol.io
 - 欢迎加入钉钉MCP交流群

package/dingtalk_contacts_mcp_server.yaml CHANGED Viewed

@@ -8,6 +8,9 @@ server:
       in: header
       name: x-acs-dingtalk-access-token
 tools:
+  - name: currentDateTime
+    description: 获取当前日期和事件
   - name: searchUser
     description: 根据姓名搜索钉钉用户的userId。
     args:

package/dingtalk_notable_mcp_server.yaml ADDED Viewed

@@ -0,0 +1,404 @@
+server:
+  name: dingtalk-notable
+  description: 钉钉AI表格/多维表
+tools:
+  - name: notableSupportedFieldInfo
+    description: AI表格/多维表支持的字段类型和额外属性
+    requestTemplate:
+      type: file
+      url: /resources/notable-field-property.md
+  - name: notableRecordValuesFormat
+    description: AI表格/多维表记录值格式
+    requestTemplate:
+      type: file
+      url: /resources/notable-record-values.md
+  - name: queryNotables
+    description: 根据名称查询AI表格/多维表
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v2.0/storage/dentries/search?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: keyword
+        description: AI表格/多维表名称
+        type: string
+        required: true
+        position: body
+      - name: option
+        description: 查询参数
+        type: object
+        required: true
+        position: body
+        items:
+          type: object
+          required:
+            - dentryCategories
+            - creatorIds
+          properties:
+            dentryCategories:
+              type: array
+              enum: [ "alidoc" ]
+              description: 文件类别
+              items:
+                type: string
+            creatorIds:
+              type: array
+              description: 创建者的userId
+              items:
+                type: string
+            nextToken:
+              type: string
+              description: 分页游标，第一次查询不需要此值，第二次查询需要，从本接口的返回值nextToken获取，如果返回值为空则说明没有更多数据
+            maxResults:
+              type: string
+              description: 分页大小，默认值10
+  # 数据表
+  - name: getNotableSheet
+    description: 获取AI表格/多维表的单个数据表
+    requestTemplate:
+      method: GET
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: query
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+  - name: getNotableAllSheets
+    description: 获取AI表格/多维表的所有数据表
+    requestTemplate:
+      method: GET
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: query
+  - name: updateNotableSheetName
+    description: 更新AI表格/多维表的单个数据表的名称
+    requestTemplate:
+      method: PUT
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: query
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+      - name: name
+        description: 数据表名称
+        type: string
+        required: true
+        position: body
+  - name: createNotableSheet
+    description: 创建AI表格/多维表的数据表
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: query
+      - name: name
+        description: 数据表ID或数据表名称。
+        type: string
+        required: true
+        position: body
+      - name: fields
+        type: array
+        required: true
+        position: body
+        items:
+          type: object
+          properties:
+            name:
+              type: string
+              description: 字段名称
+            type:
+              type: string
+              description: 字段类型，参考「notableSupportedFieldInfo」Tool返回结果中的[类型]。
+            property:
+              type: Map<String, Any>
+              description: 字段属性，具体格式请参考「notableSupportedFieldInfo」Tool返回结果中的[属性]。
+  - name: deleteNotableSheet
+    description: 删除AI表格/多维表的单个数据表
+    requestTemplate:
+      method: DELETE
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: query
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+  # 记录
+  - name: listNotableRecords
+    description: 获取AI表格/多维表里指定数据表的多行记录
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/records/list?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: path
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+      - name: maxResults
+        description: 每页记录数，最大100，默认100
+        type: integer
+        required: false
+        position: body
+      - name: nextToken
+        description: 分页游标
+        type: string
+        required: false
+        position: body
+      - name: filter
+        description: 过滤条件
+        type: object
+        required: true
+        position: body
+        items:
+          type: object
+          properties:
+            combination:
+              type: string
+              description: 条件组合方式，可选值：
+                || and：同时满足所有条件
+                || or：满足任一条件
+            conditions:
+              type: array
+              items:
+                type: object
+                properties:
+                  field:
+                    type: string
+                    description: 字段ID或字段名。
+                  operator:
+                    type: string
+                    description: 条件类型：equal | notEqual | greater | greaterEqual | less | lessEqual | contain | notContain | empty | notEmpty。
+                  value:
+                    type: string
+                    description: 字段值
+                  required:
+                    - field
+                    - operator
+                    - value
+  - name: getNotableRecord
+    description: 获取AI表格/多维表里指定数据表的单行记录
+    requestTemplate:
+      method: GET
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/records/{recordId}?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: path
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+      - name: recordId
+        description: 记录ID
+        type: string
+        required: true
+        position: path
+  - name: deleteNotableRecords
+    description: 删除AI表格/多维表里指定数据表的多行记录
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/records/delete?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: path
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+      - name: recordIds
+        description: 记录ID数组
+        type: array
+        required: true
+        position: body
+        items:
+          type: string
+  - name: insertNotableRecords
+    description: 在AI表格/多维表里指定数据表中新增行记录
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/records?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: path
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+      - name: records
+        description: 记录数组
+        type: array
+        required: true
+        position: body
+        items:
+          type: object
+          description: 该行记录中各字段的值，具体格式请参考「notableRecordValuesFormat」Tool的结果。
+          properties:
+            fields:
+              type: object
+              description: 字段键值对,key为字段ID，value为字段设置值，格式需参考「notableRecordValuesFormat」Tool的结果。
+              additionalProperties:
+                type: [ string, number, boolean, object, array] # 值可以是这些类型中的任意一种
+  # 字段
+  - name: getNotableAllFields
+    description: 获取AI表格/多维表里指定数据表的所有字段
+    requestTemplate:
+      method: GET
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/fields?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: path
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+  - name: createNotableField
+    description: 在AI表格/多维表里指定数据表中创建字段
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/fields?operatorId=String
+    args:
+      - name: operatorId
+        description: 操作人的unionId
+        type: string
+        required: true
+        position: query
+      - name: baseId
+        description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
+        type: string
+        required: true
+        position: path
+      - name: sheetIdOrName
+        description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
+        type: string
+        required: true
+        position: path
+      - name: name
+        description: 字段名称
+        type: string
+        required: true
+        position: body
+      - name: type
+        description: 字段类型，需要参考「notableSupportedFieldInfo」Tool的内容
+        type: string
+        required: true
+        position: body
+      - name: property
+        description: 字段属性，，需要参考「notableSupportedFieldInfo」Tool的对不同类型字段的属性描述。
+        type: object
+        required: false
+        position: body

package/dingtalk_report_mcp_server.yaml CHANGED Viewed

@@ -154,7 +154,7 @@ tools:
       保存日志内容供后续编辑和发送（草稿功能）。
       此接口用于保存日志内容但不立即发送，可以后续在钉钉中编辑和发送。
-      contents参数格式与createLog相同，必须包含完整的字段结构。
+      contents参数格式与「createReport」相同，必须包含完整的字段结构。
       【使用场景】
       - 需要保存日志但暂不发送

package/dist/DingTalkMCPServer.js CHANGED Viewed

@@ -1,17 +1,22 @@
-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 { LogMessageBuilder } from './utils/logBuilder.js'
+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 {LogMessageBuilder} from './utils/logBuilder.js'
+import {LocalTools} from './utils/localTools.js'
 import axios from 'axios';
 import * as yaml from 'js-yaml';
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath } from 'url';
+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 {
     constructor() {
         this.accessToken = null;
@@ -26,7 +31,7 @@ export class DingTalkMCPServer {
         this.tokenCacheFile = path.join(__dirname, '..', '.dingtalk_token_cache.json');
         this.loadConfig(path.join(__dirname, '..'));
         // 测试状态
-        if (process.env.STAGING){
+        if (process.env.STAGING) {
             this.loadConfig(path.join(__dirname, '../staging'));
         }
         this.server = new Server({
@@ -40,12 +45,13 @@ export class DingTalkMCPServer {
         this.loadTokenCache();
         this.setupHandlers();
     }
     loadConfig(dirname) {
         try {
             //激活的profile
             const profiles = process.env.ACTIVE_PROFILES;
             let profiles_list = [];
-            if (profiles){
+            if (profiles) {
                 profiles_list = profiles.split(',');
             }
@@ -64,7 +70,7 @@ export class DingTalkMCPServer {
                             (config.tools || []).forEach(tool => {
                                 if (this.tools.includes(tool.name)) {
-                                    throw new Error('Dulipict tool name: '+ tool.name);
+                                    throw new Error('Dulipict tool name: ' + tool.name);
                                 }
                                 this.tools.push(tool);
                             });
@@ -75,18 +81,19 @@ export class DingTalkMCPServer {
                 }
             );
             if (this.tools && this.tools.length > 0) {
                 console.error(`Loaded ${this.tools.length} tools from config`);
-                console.error(`Tools:\r\n${this.tools.map(t => t.name + ', '+ t.requestTemplate.method+' ' + t.requestTemplate.url  + ', ' + t.description).join('\r\n')}`);
+                console.error(`Tools:\r\n${this.tools.map(t => t.name + ', ' + t.description).join('\r\n')}`);
             }
-        }
-        catch (error) {
+        } catch (error) {
             const err = error;
             console.error('Failed to load config:', err.message);
             this.tools = [];
             throw error;
         }
     }
     /**
      * 加载本地缓存的access_token
      */
@@ -101,22 +108,20 @@ export class DingTalkMCPServer {
                     this.accessToken = cacheData.access_token;
                     console.error('Loaded valid access token from cache');
                     console.error(`Token expires at: ${new Date(cacheData.expires_at).toISOString()}`);
-                }
-                else {
+                } else {
                     console.error('Cached token expired, will refresh when needed');
                     this.clearTokenCache();
                 }
-            }
-            else {
+            } else {
                 console.error('No token cache found');
             }
-        }
-        catch (error) {
+        } catch (error) {
             const err = error;
             console.error('Failed to load token cache:', err.message);
             this.clearTokenCache();
         }
     }
     /**
      * 检查token缓存是否有效（未过期）
      */
@@ -129,6 +134,7 @@ export class DingTalkMCPServer {
         const now = Date.now();
         return now < (cacheData.expires_at - bufferTime);
     }
     /**
      * 保存access_token到本地缓存
      */
@@ -146,12 +152,12 @@ export class DingTalkMCPServer {
             fs.writeFileSync(this.tokenCacheFile, JSON.stringify(this.tokenCacheData, null, 2));
             console.error('Access token saved to cache');
             console.error(`Token expires at: ${new Date(expiresAt).toISOString()}`);
-        }
-        catch (error) {
+        } catch (error) {
             const err = error;
             console.error('Failed to save token cache:', err.message);
         }
     }
     /**
      * 清除token缓存
      */
@@ -162,12 +168,12 @@ export class DingTalkMCPServer {
                 console.error('Token cache cleared');
             }
             this.tokenCacheData = null;
-        }
-        catch (error) {
+        } catch (error) {
             const err = error;
             console.error('Failed to clear token cache:', err.message);
         }
     }
     /**
      * 获取有效的access_token（优先使用缓存）
      */
@@ -185,6 +191,7 @@ export class DingTalkMCPServer {
         console.error('Token cache invalid or missing, refreshing...');
         return await this.refreshAccessToken();
     }
     async refreshAccessToken() {
         if (!this.appId || !this.appSecret) {
             throw new Error('DINGTALK_APP_ID and DINGTALK_APP_SECRET are required');
@@ -205,26 +212,24 @@ export class DingTalkMCPServer {
                 this.saveTokenCache(this.accessToken, expiresIn);
                 console.error('Access token refreshed successfully');
                 return this.accessToken;
-            }
-            else {
+            } else {
                 throw new Error(`Token refresh failed: ${response.data.errmsg} (errcode: ${response.data.errcode})`);
             }
-        }
-        catch (error) {
+        } catch (error) {
             // 刷新失败时清除缓存
             this.clearTokenCache();
             if (axios.isAxiosError(error) && error.response) {
                 throw new Error(`Failed to refresh access token: HTTP ${error.response.status} - ${JSON.stringify(error.response.data)}`);
-            }
-            else {
+            } else {
                 const err = error;
                 throw new Error(`Failed to refresh access token: ${err.message}`);
             }
         }
     }
     setupHandlers() {
         // 列出可用工具
-        if (this.debug){
+        if (this.debug) {
             const tools = this.tools.map(tool => ({
                 name: tool.name,
                 description: tool.description,
@@ -248,19 +253,22 @@ export class DingTalkMCPServer {
                 }
             }));
-            return { tools };
+            return {tools};
         });
         // 执行工具调用
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
-            const { name, arguments: args } = request.params;
+            const {name, arguments: args} = request.params;
             const result = await this.executeTool(name, args || {});
             // 转换为 MCP SDK 期望的格式
             return {
                 content: result.content,
                 isError: result.isError
             };
         });
     }
     generateSchema(args) {
         const schema = {};
         args.forEach(arg => {
@@ -276,12 +284,13 @@ export class DingTalkMCPServer {
                 type: arg.type,
                 description: arg.description
             };
-            if ((arg.type === 'array' || arg.type === 'object' ) && arg.items) {
+            if ((arg.type === 'array' || arg.type === 'object') && arg.items) {
                 schema[arg.name].items = arg.items;
             }
         });
         return schema;
     }
     async executeTool(toolName, args) {
         const tool = this.tools.find(t => t.name === toolName);
         if (!tool) {
@@ -294,6 +303,15 @@ export class DingTalkMCPServer {
             };
         }
         try {
+            if (LocalTools.isLocalTool(toolName)){
+                return {
+                    content: [{
+                        type: 'text',
+                        text: JSON.stringify(LocalTools.callTool(tool), null, 2)
+                    }]
+                };
+            }
             // 获取有效的访问令牌（使用缓存机制）
             const accessToken = await this.getValidAccessToken();
             if (!accessToken) {
@@ -317,18 +335,18 @@ export class DingTalkMCPServer {
                 data: body,
                 timeout: 30000
             });
-            if (this.debug){
+            if (this.debug) {
                 console.log(response)
             }
             return {
                 content: [{
                     type: 'text',
                     text: JSON.stringify(response.data, null, 2)
                 }]
             };
-        }
-        catch (error) {
-            if (this.debug){
+        } catch (error) {
+            if (this.debug) {
                 console.log(error)
             }
             let errorMessage = error.message;
@@ -352,6 +370,7 @@ export class DingTalkMCPServer {
             };
         }
     }
     buildUrl(template, args) {
         let url = template;
         // 替换路径参数
@@ -373,12 +392,11 @@ export class DingTalkMCPServer {
                     if (args[key] !== undefined) {
                         queryParams.set(key, String(args[key]));
                     }
-                }
-                else {
+                } else {
                     // 处理系统参数，如自动化机器人access_token
-                    if (process.env[value]){
+                    if (process.env[value]) {
                         queryParams.set(key, process.env[value]);
-                    }else {
+                    } else {
                         queryParams.set(key, value);
                     }
                 }
@@ -393,12 +411,17 @@ export class DingTalkMCPServer {
         }
         return url;
     }
     buildHeaders(tool) {
+        if (tool.requestTemplate.url && !tool.requestTemplate.url.includes('dingtalk.com')) {
+            return;
+        }
         const headers = {
             '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('https://api.dingtalk.com') && this.accessToken) {
             headers['x-acs-dingtalk-access-token'] = this.accessToken;
         }
         if (tool.requestTemplate.headers) {
@@ -409,20 +432,20 @@ export class DingTalkMCPServer {
         return headers;
     }
-    processMultiParam(body, name, value){
+    processMultiParam(body, name, value) {
         let objParmas = name.split('.');
         if (objParmas && objParmas.length > 1) {
-            if (objParmas.length == 2){
-                if (!body[objParmas[0]]){
+            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]]){
+            if (objParmas.length == 3) {
+                if (!body[objParmas[0]]) {
                     body[objParmas[0]] = {};
                 }
-                if (!body[objParmas[0]][objParmas[1]]){
+                if (!body[objParmas[0]][objParmas[1]]) {
                     body[objParmas[0]][objParmas[1]] = {};
                 }
                 body[objParmas[0]][objParmas[1]][objParmas[2]] = value;
@@ -439,11 +462,11 @@ export class DingTalkMCPServer {
             return undefined;
         }
-        if (tool.name === 'sendServiceWindowMessage'){
+        if (tool.name === 'sendServiceWindowMessage') {
             return ServiceWindowMessageBuilder.buildSendServiceWindowMarkdownBody(args);
-        }else if (tool.name === 'batchSendServiceWindowMessage'){
+        } else if (tool.name === 'batchSendServiceWindowMessage') {
             return ServiceWindowMessageBuilder.buildBatchSendServiceWindowMarkdownBody(args);
-        }else if (tool.name === 'createLog' || tool.name === 'saveLogDraft'){
+        } else if (tool.name === 'createReport' || tool.name === 'saveReportDraft') {
             return LogMessageBuilder.buildBody(args);
         }
@@ -453,24 +476,24 @@ export class DingTalkMCPServer {
             if (arg.position === 'body') {
                 // 系统参数，从环境变量读取
                 if (arg.system) {
-                    if (!process.env[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;
                 }
                 // 不需要模型处理，直接取默认值赋值
-                if (arg.not_need_model_transform){
+                if (arg.not_need_model_transform) {
                     this.processMultiParam(body, arg.name, arg.default);
                     return;
                 }
                 // 如果模型没有对应提参，则不赋值给API对应的入参
-                if (!args[arg.name]) {
+                if (args[arg.name] == null) {
                     return;
                 }
-                if (arg.extendType === 'json'){
+                if (arg.extendType === 'json') {
                     body[arg.name] = JSON.stringify(args[arg.name]);
                     return;
                 }
@@ -496,7 +519,7 @@ export class DingTalkMCPServer {
         // 为searchUser/searchDepartment添加默认的分页参数
         // 设置默认的offset为0
-        if (tool.name === 'searchDepartment' || tool.name === 'searchUser'){
+        if (tool.name === 'searchDepartment' || tool.name === 'searchUser') {
             if (body.offset === undefined) {
                 body.offset = 0;
             }
@@ -516,4 +539,5 @@ export class DingTalkMCPServer {
         console.error('DingTalk MCP server running on stdio');
     }
 }
 //# sourceMappingURL=DingTalkMCPServer.js.map

package/dist/resources/notable-field-property.md ADDED Viewed

@@ -0,0 +1,17 @@
+# 字段属性
+该文档介绍了AI表格中字段属性的相关配置。
+| 字段名 | 类型 (type) | 属性 (property) |
+| --- | --- | --- |
+| 文本  | text | 无   |
+| 数字  | number | ```  {      formatter: "INT"        // 整数          \| "FLOAT_1"         // 保留1位小数          \| "FLOAT_2"         // 保留2位小数          \| "FLOAT_3"         // 保留3位小数          \| "FLOAT_4"         // 保留4位小数          \| "THOUSAND"        // 千分位          \| "THOUSAND_FLOAT"  // 千分位（小数点）          \| "PRESENT"         // 百分比          \| "PRESENT_FLOAT"   // 百分比（小数点）          \| "CNY"             // 人民币          \| "CNY_FLOAT"       // 人民币（小数点）          \| "HKD"             // 港元          \| "HKD_FLOAT"       // 港元（小数点）          \| "USD"             // 美元          \| "USD_FLOAT"       // 美元（小数点）          \| "EUR"             // 欧元          \| "EUR_FLOAT"       // 欧元（小数点）          \| "JPY"             // 日元          \| "JPY_FLOAT";      // 日元（小数点）  }  ``` |
+| 单选  | singleSelect | ```  {      choices: [{          name: "optionName1" // 配置选项名      }, {          name: "optionName2"      }];  }  ``` |
+| 多选  | multipleSelect | 同「单选」 |
+| 日期  | date | ```  {      formatter: "YYYY-MM-DD"    // 显示格式: 2023-12-31          \| "YYYY-MM-DD HH:mm"   // 显示格式: 2023-12-31 09:00          \| "YYYY/MM/DD"         // 显示格式: 2023/12/31          \| "YYYY/MM/DD HH:mm";  // 显示格式: 2023/12/31 09:00  }  ``` |
+| 人员  | user | ```  {    multiple: boolean; // 支持多选，默认为true  }  ``` |
+| 部门  | department | ```  {    multiple: boolean; // 支持多选，默认为true  }  ``` |
+| 附件  | attachment | 无   |
+| 单向关联 | unidirectionalLink | ```  {    multiple: boolean; // 支持多选，默认为true    linkedSheetId: "xxx" // 关联的数据表ID  }  ``` |
+| 双向关联 | bidirectionalLink | ```  {    multiple: boolean; // 支持多选，默认为true    linkedSheetId: "xxx", // 关联的数据表ID    linkedFieldId: "yyy" // 关联的数据表上的字段ID，创建字段时不传  }  ``` |
+| 链接  | url | 无   |

package/dist/resources/notable-record-values.md ADDED Viewed

@@ -0,0 +1,18 @@
+# 记录值格式
+该文档介绍AI表格中记录值的读写格式。
+不同字段类型所使用的格式请参考下表：
+| 字段名 | 类型 (type) | 设置值（新增/更新记录时使用的格式） | 返回值（返回记录值时返回的格式） |
+| --- | --- | --- | --- |
+| 文本  | text | `"TextString" // 字符串` | `"TextString" // 字符串` |
+| 数字  | number | `123 // 支持整数/浮点数/字符串` | `"123" // 数字值，以字符串形式返回` |
+| 单选  | singleSelect | `"optionName1" // 单选选项名` | `{   "id": "id", // 选项ID   "name": "optionName1" // 选项名 }` |
+| 多选  | multipleSelect | `["optionName1", "optionName2"] // 多选选项名` | `[   {     "id": "id1", // 选项ID     "name": "optionName1" // 选项名   },   {     "id": "id2", // 选项ID     "name": "optionName2" // 选项名   } ]` |
+| 日期  | date | `1688601600000 // 时间戳 "2023-12-20 03:00" // 或者 ISO 8601字符串` | `1688601600000 // 时间戳` |
+| 人员  | user | `[   {     unionId: "xxx"   } ]` | `[   {     unionId: "xxx"   } ]` |
+| 部门  | department | `[   {     deptId: "xxx"   } ]` | `[   {     deptId: "xxx"   } ]` |
+| 附件  | attachment | 具体请参考[上传附件](https://open.dingtalk.com/document/orgapp/notable-upload-attachment) 。 | `[   {     "filename": "image.xlsx",     "size": 92250,     "type": "xls",     "url": "xxx"   } ]`<br>                                <br><br>**说明**<br><br>url是附件访问链接。<br><br>*   当附件是在线文档时，其是在线文档链接，该链接没有访问时效。<br>    <br>*   当附件是其它文件时，是一个有**访问时效** 的下载链接，一段时间后该链接将无法访问。 |
+| 单向关联 | unidirectionalLink | `{     "linkedRecordIds": [         "xxx",         "yyy"     ] }` | `{     "linkedRecordIds": [         "xxx",         "yyy"     ] }`<br>                                <br><br>**说明**<br><br>field property中包含关联的sheetId，配合这里返回的recordId，可以通过调用[获取记录](/document/orgapp/api-getrecord#) 接口去获取关联记录的值。 |
+| 双向关联 | bidirectionalLink | `{     "linkedRecordIds": [         "xxx",         "yyy"     ] }` | `{     "linkedRecordIds": [         "xxx",         "yyy"     ] }` |
+| 链接  | url | `{   "text": "Dingtalk",   "link": "https://dingtalk.com" }` | `{   "text": "Dingtalk",   "link": "https://dingtalk.com" }` |

package/dist/utils/DateUtils.js ADDED Viewed

@@ -0,0 +1,29 @@
+/**
+ * 日期和时间处理的工具类 (适用于 Node.js 环境)
+ */
+export class DateUtils {
+    /**
+     * 异步获取当前时间，并根据运行环境的区域和时区设置进行格式化。
+     * @returns {Promise<string>} 一个 Promise，解析为格式化后的本地时间字符串, e.g., "2023-10-27 16:45:30"
+     */
+    static getFormattedLocalNow() {
+        // 1. 异步、安全地获取操作系统的区域设置，提供一个后备值
+        const locale = Intl.DateTimeFormat().resolvedOptions().locale || 'zh-CN';
+        // 2. Intl.DateTimeFormat 默认就会使用环境时区
+        const formatter = new Intl.DateTimeFormat(locale, {
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false // 使用24小时制
+        });
+        // 3. 格式化并统一分隔符
+        return formatter.format(new Date()).replace(/\//g, '-');
+    }
+}

package/dist/utils/file.js ADDED Viewed

@@ -0,0 +1,14 @@
+import path, {normalize} from 'path';
+import fs from "fs";
+import {fileURLToPath} from 'url';
+export class FileUtils {
+    static readLocalFileContent(tool){
+        if (tool.requestTemplate.type === "file"){
+            const __filename = fileURLToPath(import.meta.url);
+            const __dirname = path.dirname(__filename);
+            return fs.readFileSync(path.join(path.join(__dirname, '..'), tool.requestTemplate.url), 'utf8');
+        }
+    }
+}

package/dist/utils/localTools.js ADDED Viewed

@@ -0,0 +1,20 @@
+import {DateUtils} from './DateUtils.js'
+import {FileUtils} from './file.js'
+const localTools = ["currentDateTime", "notableSupportedFieldInfo", "notableRecordValuesFormat"]
+export class LocalTools{
+    static isLocalTool(toolName){
+        return localTools.includes(toolName)
+    }
+    static callTool(tool){
+        if (tool.name === "currentDateTime"){
+            return DateUtils.getFormattedLocalNow();
+        }else if (tool.name === "notableSupportedFieldInfo" || tool.name === "notableRecordValuesFormat"){
+            return FileUtils.readLocalFileContent(tool);
+        }
+    }
+}

package/package.json CHANGED Viewed

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