dingtalk-mcp 1.1.10 → 1.1.13
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.
|
@@ -9,10 +9,10 @@ server:
|
|
|
9
9
|
name: x-acs-dingtalk-access-token
|
|
10
10
|
tools:
|
|
11
11
|
- name: currentDateTime
|
|
12
|
-
description:
|
|
12
|
+
description: 获取当前日期和时间
|
|
13
13
|
|
|
14
14
|
- name: searchUser
|
|
15
|
-
description:
|
|
15
|
+
description: 根据姓名搜索钉钉通讯录用户的userId。
|
|
16
16
|
args:
|
|
17
17
|
- name: queryWord
|
|
18
18
|
description: 搜索关键词，可以是用户姓名、姓名拼音或英文名称。
|
|
@@ -22,7 +22,7 @@ tools:
|
|
|
22
22
|
url: https://api.dingtalk.com/v2.0/storage/dentries/search?operatorId=String
|
|
23
23
|
args:
|
|
24
24
|
- name: operatorId
|
|
25
|
-
description: 操作人的unionId
|
|
25
|
+
description: 操作人的unionId，如果找不到，可以从通讯录相关Tool中获取。
|
|
26
26
|
type: string
|
|
27
27
|
required: true
|
|
28
28
|
position: query
|
|
@@ -61,7 +61,7 @@ tools:
|
|
|
61
61
|
description: 分页大小，默认值10
|
|
62
62
|
# 数据表
|
|
63
63
|
- name: getNotableSheet
|
|
64
|
-
description: 获取AI
|
|
64
|
+
description: 获取AI表格/多维表的单个数据表的ID和名称
|
|
65
65
|
requestTemplate:
|
|
66
66
|
method: GET
|
|
67
67
|
url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}?operatorId=String
|
|
@@ -244,8 +244,10 @@ tools:
|
|
|
244
244
|
type: string
|
|
245
245
|
description: 条件类型：equal | notEqual | greater | greaterEqual | less | lessEqual | contain | notContain | empty | notEmpty。
|
|
246
246
|
value:
|
|
247
|
-
type:
|
|
248
|
-
description:
|
|
247
|
+
type: array
|
|
248
|
+
description: 字段值，必须是数组类型，数组内格式需要参考「notableRecordValuesFormat」Tool结果中「设置值」格式要求。
|
|
249
|
+
items:
|
|
250
|
+
type: any
|
|
249
251
|
required:
|
|
250
252
|
- field
|
|
251
253
|
- operator
|
|
@@ -339,9 +341,64 @@ tools:
|
|
|
339
341
|
properties:
|
|
340
342
|
fields:
|
|
341
343
|
type: object
|
|
342
|
-
description:
|
|
343
|
-
|
|
344
|
-
|
|
344
|
+
description: |
|
|
345
|
+
字段键值对,key为字段ID或名称，value为字段设置值，格式需参考「notableRecordValuesFormat」Tool的结果。
|
|
346
|
+
参考如下结构图：
|
|
347
|
+
"fields":{
|
|
348
|
+
"人员2":[
|
|
349
|
+
{
|
|
350
|
+
unionId: "oEoTOxbGV6o7AiSB5RcfrTAiEiE"
|
|
351
|
+
}
|
|
352
|
+
],
|
|
353
|
+
"标题": "name"
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
- name: updateNotableRecords
|
|
357
|
+
description: 更新AI表格/多维表里指定数据表的多行记录
|
|
358
|
+
requestTemplate:
|
|
359
|
+
method: PUT
|
|
360
|
+
url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/records?operatorId=String
|
|
361
|
+
args:
|
|
362
|
+
- name: operatorId
|
|
363
|
+
description: 操作人的unionId
|
|
364
|
+
type: string
|
|
365
|
+
required: true
|
|
366
|
+
position: query
|
|
367
|
+
- name: baseId
|
|
368
|
+
description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
|
|
369
|
+
type: string
|
|
370
|
+
required: true
|
|
371
|
+
position: path
|
|
372
|
+
- name: sheetIdOrName
|
|
373
|
+
description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
|
|
374
|
+
type: string
|
|
375
|
+
required: true
|
|
376
|
+
position: path
|
|
377
|
+
- name: records
|
|
378
|
+
description: 记录数组，每个记录包含id和fields字段
|
|
379
|
+
type: array
|
|
380
|
+
required: true
|
|
381
|
+
position: body
|
|
382
|
+
items:
|
|
383
|
+
type: object
|
|
384
|
+
properties:
|
|
385
|
+
id:
|
|
386
|
+
type: string
|
|
387
|
+
description: 记录ID
|
|
388
|
+
fields:
|
|
389
|
+
type: object
|
|
390
|
+
description: |
|
|
391
|
+
字段键值对，key为字段ID，value为字段设置值，格式需参考「notableRecordValuesFormat」Tool的结果。
|
|
392
|
+
参考如下结构图：
|
|
393
|
+
"fields":{
|
|
394
|
+
"人员2":[
|
|
395
|
+
{
|
|
396
|
+
unionId: "oEoTOxbGV6o7AiSB5RcfrTAiEiE"
|
|
397
|
+
}
|
|
398
|
+
],
|
|
399
|
+
"标题": "name"
|
|
400
|
+
}
|
|
401
|
+
|
|
345
402
|
|
|
346
403
|
# 字段
|
|
347
404
|
- name: getNotableAllFields
|
|
@@ -393,7 +450,7 @@ tools:
|
|
|
393
450
|
required: true
|
|
394
451
|
position: body
|
|
395
452
|
- name: type
|
|
396
|
-
description: 字段类型，需要参考「notableSupportedFieldInfo」Tool
|
|
453
|
+
description: 字段类型，需要参考「notableSupportedFieldInfo」Tool的对不同类型字段的类型描述。
|
|
397
454
|
type: string
|
|
398
455
|
required: true
|
|
399
456
|
position: body
|
|
@@ -401,4 +458,68 @@ tools:
|
|
|
401
458
|
description: 字段属性，，需要参考「notableSupportedFieldInfo」Tool的对不同类型字段的属性描述。
|
|
402
459
|
type: object
|
|
403
460
|
required: false
|
|
404
|
-
position: body
|
|
461
|
+
position: body
|
|
462
|
+
|
|
463
|
+
- name: deleteNotableField
|
|
464
|
+
description: 删除AI表格/多维表里指定数据表的字段
|
|
465
|
+
requestTemplate:
|
|
466
|
+
method: DELETE
|
|
467
|
+
url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName}?operatorId=String
|
|
468
|
+
args:
|
|
469
|
+
- name: operatorId
|
|
470
|
+
description: 操作人的unionId
|
|
471
|
+
type: string
|
|
472
|
+
required: true
|
|
473
|
+
position: query
|
|
474
|
+
- name: baseId
|
|
475
|
+
description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
|
|
476
|
+
type: string
|
|
477
|
+
required: true
|
|
478
|
+
position: path
|
|
479
|
+
- name: sheetIdOrName
|
|
480
|
+
description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
|
|
481
|
+
type: string
|
|
482
|
+
required: true
|
|
483
|
+
position: path
|
|
484
|
+
- name: fieldIdOrName
|
|
485
|
+
description: 字段ID或字段名称
|
|
486
|
+
type: string
|
|
487
|
+
required: true
|
|
488
|
+
position: path
|
|
489
|
+
|
|
490
|
+
- name: updateNotableField
|
|
491
|
+
description: 更新AI表格/多维表里指定数据表的字段，建议先从「getNotableAllFields」Tool中获取要更新字段的类型。
|
|
492
|
+
requestTemplate:
|
|
493
|
+
method: PUT
|
|
494
|
+
url: https://api.dingtalk.com/v1.0/notable/bases/{baseId}/sheets/{sheetIdOrName}/fields/{fieldIdOrName}?operatorId=String
|
|
495
|
+
args:
|
|
496
|
+
- name: operatorId
|
|
497
|
+
description: 操作人的unionId
|
|
498
|
+
type: string
|
|
499
|
+
required: true
|
|
500
|
+
position: query
|
|
501
|
+
- name: baseId
|
|
502
|
+
description: AI表格/多维表ID，从「根据名称查询AI表格/多维表」Tool中的结果字段「dentryUuid」获取。
|
|
503
|
+
type: string
|
|
504
|
+
required: true
|
|
505
|
+
position: path
|
|
506
|
+
- name: sheetIdOrName
|
|
507
|
+
description: 数据表ID或数据表名称。数据表ID可以通过调用「getNotableAllSheets」获取
|
|
508
|
+
type: string
|
|
509
|
+
required: true
|
|
510
|
+
position: path
|
|
511
|
+
- name: fieldIdOrName
|
|
512
|
+
description: 字段ID或字段名称
|
|
513
|
+
type: string
|
|
514
|
+
required: true
|
|
515
|
+
position: path
|
|
516
|
+
- name: name
|
|
517
|
+
description: 字段名称
|
|
518
|
+
type: string
|
|
519
|
+
required: true
|
|
520
|
+
position: body
|
|
521
|
+
- name: property
|
|
522
|
+
description: 字段属性，需要参考「notableSupportedFieldInfo」Tool的对不同类型字段的属性描述。
|
|
523
|
+
type: object
|
|
524
|
+
required: false
|
|
525
|
+
position: body
|
|
@@ -2,16 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
该文档介绍了AI表格中字段属性的相关配置。
|
|
4
4
|
|
|
5
|
-
| 字段名 | 类型 (type) | 属性 (property)
|
|
6
|
-
| --- | ---
|
|
7
|
-
| 文本 | text | 无
|
|
5
|
+
| 字段名 | 类型 (type) | 属性 (property) |
|
|
6
|
+
| --- | --- |------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
7
|
+
| 文本 | text | 无 |
|
|
8
8
|
| 数字 | 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"; // 日元（小数点） } ``` |
|
|
9
|
-
| 单选 | singleSelect | ``` { choices: [{ name: "optionName1" // 配置选项名 }, { name: "optionName2" }]; } ```
|
|
10
|
-
| 多选 | multipleSelect | 同「单选」
|
|
11
|
-
| 日期 | date | ``` { formatter: "YYYY-MM-DD" // 显示格式: 2023-12-31 \| "YYYY-MM-DD HH:mm" // 显示格式: 2023-12-31 09:00
|
|
12
|
-
| 人员 | user | ``` { multiple: boolean; // 支持多选，默认为true } ```
|
|
13
|
-
| 部门 | department | ``` { multiple: boolean; // 支持多选，默认为true } ```
|
|
14
|
-
| 附件 | attachment | 无
|
|
15
|
-
| 单向关联 | unidirectionalLink | ``` { multiple: boolean; // 支持多选，默认为true linkedSheetId: "xxx" // 关联的数据表ID } ```
|
|
16
|
-
| 双向关联 | bidirectionalLink | ``` { multiple: boolean; // 支持多选，默认为true linkedSheetId: "xxx", // 关联的数据表ID linkedFieldId: "yyy" // 关联的数据表上的字段ID，创建字段时不传 } ```
|
|
17
|
-
| 链接 | url | 无
|
|
9
|
+
| 单选 | singleSelect | ``` { choices: [{ name: "optionName1" // 配置选项名 }, { name: "optionName2" }]; } ``` |
|
|
10
|
+
| 多选 | multipleSelect | 同「单选」 |
|
|
11
|
+
| 日期 | date | ``` { formatter: "YYYY-MM-DD" // 显示格式: 2023-12-31 \| "YYYY-MM-DD HH:mm" // 显示格式: 2023-12-31 09:00 \| "YYYY-MM-DD HH:mm:ss" // 显示格式: 2023-12-31 09:00:01 \| "YYYY/MM/DD" // 显示格式: 2023/12/31 \| "YYYY/MM/DD HH:mm"; // 显示格式: 2023/12/31 09:00 } ``` |
|
|
12
|
+
| 人员 | user | ``` { multiple: boolean; // 支持多选，默认为true } ``` |
|
|
13
|
+
| 部门 | department | ``` { multiple: boolean; // 支持多选，默认为true } ``` |
|
|
14
|
+
| 附件 | attachment | 无 |
|
|
15
|
+
| 单向关联 | unidirectionalLink | ``` { multiple: boolean; // 支持多选，默认为true linkedSheetId: "xxx" // 关联的数据表ID } ``` |
|
|
16
|
+
| 双向关联 | bidirectionalLink | ``` { multiple: boolean; // 支持多选，默认为true linkedSheetId: "xxx", // 关联的数据表ID linkedFieldId: "yyy" // 关联的数据表上的字段ID，创建字段时不传 } ``` |
|
|
17
|
+
| 链接 | url | 无 |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dingtalk-mcp",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.13",
|
|
4
4
|
"description": "DingTalk MCP Server - A TypeScript-based MCP server for DingTalk integration",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -29,6 +29,7 @@
|
|
|
29
29
|
"dependencies": {
|
|
30
30
|
"@modelcontextprotocol/sdk": "^0.4.0",
|
|
31
31
|
"axios": "^1.6.0",
|
|
32
|
+
"dingtalk-mcp": "file:dingtalk-mcp-1.1.12.tgz",
|
|
32
33
|
"dotenv": "^16.3.0",
|
|
33
34
|
"js-yaml": "^4.1.0"
|
|
34
35
|
},
|