dingtalk-mcp 1.1.2 → 1.1.3

package/README.md

@@ -64,6 +64,7 @@
 
 ## 📞 支持
 
+- 帮助文档： https://open.dingtalk.com/document/ai-dev/dingtalk-server-api-mcp-overview
 - 钉钉开放平台: https://open.dingtalk.com
 - MCP协议: https://modelcontextprotocol.io
 - 欢迎加入钉钉MCP交流群

package/dingtalk_calendar_mcp_server.yaml

@@ -1,715 +1,355 @@
 server:
   name: dingtalk-calendar
-  description: 钉钉日历
-  securitySchemes:
-    - id: DingTalkAuth
-      type: apiKey
-      in: header
-      name: x-acs-dingtalk-access-token
+  description: 钉钉日程
 tools:
-  - name: addAttendee
-    description: "向指定日程添加参与者，支持批量添加多人，可设置参与者类型和通知方式"
+  - name: createEvent
+    description: 创建一个新的日程，支持设置时间、地点、参与者、提醒、重复规则等
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events
     args:
-      - name: attendeesToAdd
-        description: "需要添加的参与者列表，包含用户ID和参与类型"
-        type: array
+      - name: unionId
+        type: string
         required: true
-        items:
-          type: object
-        position: body
+        position: path
+        description: 日程组织者的unionId
       - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
         type: string
         required: true
         position: path
-      - name: chatNotification
-        description: "是否发送单聊通知"
-        type: boolean
-        position: body
-      - name: eventId
-        description: "日程ID"
+        description: 日程所属的日历ID，统一为primary，表示用户的主日历
+      - name: summary
         type: string
         required: true
-        position: path
-      - name: id
-        description: "参与者的用户ID"
+        position: body
+        description: 日程标题，最大不超过2048个字符
+      - name: description
         type: string
+        required: false
         position: body
-      - name: isOptional
-        description: "是否为可选参与者（true=可选，false=必须）"
-        type: boolean
+        description: 日程描述，最大不超过5000个字符
+      - name: start
+        type: object
+        required: true
         position: body
-      - name: pushNotification
-        description: "是否发送弹窗提醒"
+        description: 日程开始时间对象。非全天日程格式示例：{"dateTime":"2025-09-20T10:15:30+08:00","timeZone":"Asia/Shanghai"}；全天日程格式：{"date":"2025-09-20"}
+      - name: end
+        type: object
+        required: false
+        position: body
+        description: 日程结束时间对象。非全天日程格式示例：{"dateTime":"2025-09-20T11:15:30+08:00","timeZone":"Asia/Shanghai"}；全天日程格式：{"date":"2025-09-21"}（全天日程结束日期需要+1天）
+      - name: isAllDay
         type: boolean
+        required: false
         position: body
-      - name: userId
-        description: "日程创建者的userId"
-        type: string
-        required: true
-        position: path
-      - name: x-client-token
-        description: "幂等性校验令牌，避免重复请求"
-        type: string
-        position: header
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}/attendees
-      method: POST
-      headers:
-        - key: Content-Type
-          value: application/json
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 日程参与者添加结果
-
-        {{if .success}}
-        ✅ **操作成功** - 已成功向日程添加参与者
-
-        **日程信息**:
-        - 日程ID: {{.eventId}}
-        - 操作时间: {{.timestamp}}
-        
-        **添加的参与者**:
-        {{range $i, $attendee := .attendees}}
-        {{add $i 1}}. {{$attendee.displayName}} 
-           - unionId: {{$attendee.id}}
-           - 参与类型: {{if $attendee.isOptional}}可选参与{{else}}必须参与{{end}}
-           - 通知状态: {{if $attendee.notified}}已通知{{else}}未通知{{end}}
-        {{end}}
-
-        {{if .notifications}}
-        **通知发送状态**:
-        - 单聊通知: {{if .notifications.chatSent}}已发送{{else}}未发送{{end}}
-        - 弹窗提醒: {{if .notifications.pushSent}}已发送{{else}}未发送{{end}}
-        {{end}}
-
-        {{else}}
-        ❌ **操作失败** - {{.error}}
-        
-        **错误详情**: {{.errorMessage}}
-        {{end}}
+        description: 是否全天日程
+      - name: location
+        type: object
+        required: false
+        position: body
+        description: 日程地点对象，包含displayName字段。示例：{"displayName":"会议室A"}
+      - name: attendees
+        type: array
+        required: false
+        position: body
+        description: 日程参与人列表，最多支持500个参与人。数组中每个对象包含id（用户unionId）和isOptional（是否可选参与人）字段。示例：[{"id":"unionId123","isOptional":false}]
+      - name: reminders
+        type: array
+        required: false
+        position: body
+        description: 日程提醒设置，数组中每个对象包含method和minutes字段。如不传默认开始前15分钟提醒，传空数组表示不设提醒。method只支持"dingtalk"（钉钉内提醒），minutes为Integer类型表示提前N分钟提醒。示例：[{"method":"dingtalk","minutes":15}]
+      - name: recurrence
+        type: object
+        required: false
+        position: body
+        description: 日程循环规则对象
+      - name: onlineMeetingInfo
+        type: object
+        required: false
+        position: body
+        description: 创建日程同时创建线上会议。对象包含type字段，目前只支持"dingtalk"（钉钉视频会议）。示例：{"type":"dingtalk"}
+      - name: extra
+        type: object
+        required: false
+        position: body
+        description: 扩展配置，如noPushNotification、noChatNotification等。示例：{"noPushNotification":"true","noChatNotification":"false"}
+      - name: uiConfigs
+        type: array
+        required: false
+        position: body
+        description: UI配置，控制日程详情页内组件的展示
+      - name: richTextDescription
+        type: object
+        required: false
+        position: body
+        description: 富文本描述对象
 
-  - name: createEvent
-    description: "创建新的日程，支持设置时间、参与者、提醒等完整功能"
+  - name: updateEvent
+    description: 修改已存在的日程信息
+    requestTemplate:
+      method: PUT
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events/{eventId}
     args:
-      - name: userId
-        description: "日程创建者的userId"
+      - name: unionId
         type: string
         required: true
         position: path
+        description: 日程组织者的unionId
       - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
         type: string
         required: true
         position: path
-      - name: summary
-        description: "日程标题"
+        description: 日程所属的日历ID，统一为primary
+      - name: eventId
         type: string
         required: true
+        position: path
+        description: 要修改的日程ID
+      - name: summary
+        type: string
+        required: false
         position: body
+        description: 日程标题
+      - name: description
+        type: string
+        required: false
+        position: body
+        description: 日程描述
       - name: start
-        description: "日程开始时间"
         type: object
-        required: true
+        required: false
         position: body
+        description: 日程开始时间对象。非全天日程格式：{"dateTime":"2021-09-20T10:15:30+08:00","timeZone":"Asia/Shanghai"}；全天日程格式：{"date":"2021-09-20"}
       - name: end
-        description: "日程结束时间"
         type: object
-        required: true
-        position: body
-      - name: description
-        description: "日程描述内容"
-        type: string
+        required: false
         position: body
+        description: 日程结束时间对象。非全天日程格式：{"dateTime":"2021-09-20T11:15:30+08:00","timeZone":"Asia/Shanghai"}；全天日程格式：{"date":"2021-09-21"}（全天日程结束日期需要+1天）
       - name: isAllDay
-        description: "是否为全天日程"
         type: boolean
+        required: false
         position: body
-      - name: attendees
-        description: "参与者列表"
+        description: 是否全天日程
+      - name: location
+        type: object
+        required: false
+        position: body
+        description: 日程地点对象，包含displayName字段。示例：{"displayName":"会议室A"}
+      - name: reminders
         type: array
-        items:
-          type: object
+        required: false
         position: body
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events
-      method: POST
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 日程创建结果
-
-        {{if .success}}
-        ✅ **日程创建成功**
-
-        **日程信息**:
-        - 📅 标题: {{.summary}}
-        - 🆔 日程ID: {{.id}}
-        - ⏰ 开始时间: {{.start.dateTime | formatTime}}
-        - ⏰ 结束时间: {{.end.dateTime | formatTime}}
-        - 📍 类型: {{if .isAllDay}}全天日程{{else}}定时日程{{end}}
-        {{if .description}}
-        - 📝 描述: {{.description}}
-        {{end}}
-        {{if .location}}
-        - 📍 地点: {{.location.displayName}}
-        {{end}}
-
-        {{if .attendees}}
-        **参与者** ({{len .attendees}}人):
-        {{range $i, $attendee := .attendees}}
-        {{add $i 1}}. {{$attendee.displayName}}{{if $attendee.isOptional}} (可选){{end}}
-        {{end}}
-        {{end}}
-
-        **访问方式**:
-        - 日程链接: {{.webLink}}
-        {{if .onlineMeeting}}
-        - 会议链接: {{.onlineMeeting.joinUrl}}
-        {{end}}
-
-        {{else}}
-        ❌ **日程创建失败** - {{.error}}
-        
-        **错误详情**: {{.errorMessage}}
-        {{end}}
+        description: 日程提醒设置，数组中每个对象包含method和minutes字段。method只支持"dingtalk"（钉钉内提醒），minutes为Integer类型表示提前N分钟提醒。示例：[{"method":"dingtalk","minutes":15}]
+      - name: recurrence
+        type: object
+        required: false
+        position: body
+        description: 日程循环规则对象
+      - name: extra
+        type: object
+        required: false
+        position: body
+        description: 扩展配置，如noPushNotification、noChatNotification等。示例：{"noPushNotification":"true","noChatNotification":"false"}
 
   - name: deleteEvent
-    description: "删除指定日程，组织者删除将通知所有参与者，参与者删除仅从自己日历移除"
+    description: 删除指定的日程
+    requestTemplate:
+      method: DELETE
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events/{eventId}
     args:
+      - name: unionId
+        type: string
+        required: true
+        position: path
+        description: 日程组织者的unionId
       - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
         type: string
         required: true
         position: path
+        description: 日程所属的日历ID，统一为primary
       - name: eventId
-        description: "要删除的日程ID"
         type: string
         required: true
         position: path
+        description: 要删除的日程ID
       - name: pushNotification
-        description: "是否发送弹窗通知"
         type: boolean
+        required: false
         position: query
-      - name: userId
-        description: "执行删除操作的userId"
-        type: string
-        required: true
-        position: path
-      - name: x-client-token
-        description: "幂等性校验令牌"
-        type: string
-        position: header
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}?pushNotification=Boolean
-      method: DELETE
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 日程删除结果
-
-        {{if .success}}
-        ✅ **日程删除成功**
-
-        **删除信息**:
-        - 日程ID: {{.eventId}}
-        - 删除者: {{.deletedBy}}
-        - 删除时间: {{.deletedAt | formatTime}}
-        - 影响范围: {{if .isOrganizer}}所有参与者（组织者删除）{{else}}仅自己（参与者退出）{{end}}
+        description: 是否发送弹窗提醒
 
-        {{if .notifications}}
-        **通知状态**:
-        {{if .isOrganizer}}
-        - 取消通知已发送给 {{.notifications.notifiedCount}} 位参与者
-        {{end}}
-        - 弹窗提醒: {{if .notifications.pushSent}}已发送{{else}}未发送{{end}}
-        {{end}}
-
-        {{else}}
-        ❌ **日程删除失败** - {{.error}}
-        
-        **错误详情**: {{.errorMessage}}
-        {{end}}
-
-  - name: getEventsView
-    description: "查询指定时间范围内的日程视图，支持循环日程展开显示"
-    args:
-      - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
-        type: string
-        required: true
-        position: path
-      - name: maxAttendees
-        description: "每个日程返回的参与者数量上限（默认100，最大100）"
-        type: integer
-        position: query
-      - name: maxResults
-        description: "返回的日程数量上限（默认100，最大100）"
-        type: integer
-        position: query
-      - name: nextToken
-        description: "分页标记，用于获取下一页数据"
-        type: string
-        position: query
-      - name: timeMax
-        description: "查询结束时间（ISO-8601格式）"
-        type: string
-        position: query
-      - name: timeMin
-        description: "查询开始时间（ISO-8601格式）"
-        type: string
-        position: query
-      - name: userId
-        description: "要查询的userId"
-        type: string
-        required: true
-        position: path
+  - name: getEvent
+    description: 查询单个日程的详细信息
     requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/eventsview?timeMin=String&timeMax=String&maxResults=Long&nextToken=String
       method: GET
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 📅 日程视图查询结果
-
-        {{if .events}}
-        **查询范围**: {{.timeMin | formatTime}} 至 {{.timeMax | formatTime}}
-        **找到日程**: {{len .events}} 个{{if .hasMore}}（显示部分，还有更多）{{end}}
-
-        {{range $i, $event := .events}}
-        ## {{add $i 1}}. {{$event.summary}}
-
-        **⏰ 时间**: {{$event.start.dateTime | formatTime}} - {{$event.end.dateTime | formatTime}}
-        {{if $event.isAllDay}}**📅 类型**: 全天日程{{end}}
-        {{if $event.location}}**📍 地点**: {{$event.location.displayName}}{{end}}
-        {{if $event.description}}**📝 描述**: {{$event.description | truncate 100}}{{end}}
-        {{if $event.attendees}}**👥 参与者**: {{len $event.attendees}}人{{end}}
-        {{if $event.seriesMasterId}}**🔄 循环**: 这是循环日程的一个实例{{end}}
-
-        {{end}}
-
-        {{if .nextToken}}
-        ---
-        **📄 分页信息**: 使用 nextToken "{{.nextToken}}" 获取更多结果
-        {{end}}
-
-        {{else}}
-        📭 **暂无日程**
-
-        指定时间范围内没有找到任何日程。
-        {{end}}
-
-  - name: getEventDetails
-    description: "获取指定日程的详细信息，包含完整的参与者、位置、描述等信息"
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events/{eventId}
     args:
-      - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
+      - name: unionId
         type: string
         required: true
         position: path
-      - name: eventId
-        description: "日程ID"
+        description: 日程组织者的unionId
+      - name: calendarId
         type: string
         required: true
         position: path
-      - name: userId
-        description: "查询者的userId"
+        description: 日程所属的日历ID，统一为primary
+      - name: eventId
         type: string
         required: true
         position: path
+        description: 要查询的日程ID
       - name: maxAttendees
-        description: "返回的参与者数量上限（默认100，最大100）"
-        type: integer
+        type: number
+        required: false
         position: query
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}?maxAttendees=Long
-      method: GET
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 📅 日程详情
+        description: 返回的参与者列表的最大数量
 
-        ## {{.summary}}
 
-        **基本信息**:
-        - 🆔 日程ID: {{.id}}
-        - ⏰ 开始时间: {{.start.dateTime | formatTime}}
-        - ⏰ 结束时间: {{.end.dateTime | formatTime}}
-        - 📅 类型: {{if .isAllDay}}全天日程{{else}}定时日程{{end}}
-        - 👤 创建者: {{.organizer.displayName}}
-        - 📊 状态: {{.status}}
-
-        {{if .description}}
-        **📝 详细描述**:
-        {{.description}}
-        {{end}}
-
-        {{if .location}}
-        **📍 会议地点**:
-        {{.location.displayName}}
-        {{end}}
-
-        {{if .onlineMeeting}}
-        **💻 在线会议**:
-        - 会议链接: {{.onlineMeeting.joinUrl}}
-        - 会议ID: {{.onlineMeeting.conferenceId}}
-        {{end}}
-
-        {{if .attendees}}
-        **👥 参与者** ({{len .attendees}}人):
-        {{range $i, $attendee := .attendees}}
-        {{add $i 1}}. {{$attendee.displayName}}
-           - 状态: {{$attendee.responseStatus}}{{if $attendee.isOptional}} (可选参与){{end}}
-           {{if $attendee.comment}}- 备注: {{$attendee.comment}}{{end}}
-        {{end}}
-        {{end}}
-
-        {{if .recurrence}}
-        **🔄 重复设置**:
-        {{.recurrence | formatRecurrence}}
-        {{end}}
-
-        {{if .reminders}}
-        **⏰ 提醒设置**:
-        {{range $reminder := .reminders}}
-        - {{$reminder.method}}: 提前{{$reminder.minutes}}分钟
-        {{end}}
-        {{end}}
-
-  - name: listAttendees
-    description: "获取指定日程的所有参与者列表及其状态信息"
+  - name: addAttendee
+    description: 添加日程参与者，每次最多支持操作500人
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events/{eventId}/attendees
     args:
-      - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
+      - name: unionId
         type: string
         required: true
         position: path
-      - name: eventId
-        description: "日程ID"
+        description: 日程创建者的unionId
+      - name: calendarId
         type: string
         required: true
         position: path
-      - name: maxResults
-        description: "返回的参与者数量上限（默认100，最大500）"
-        type: integer
-        position: query
-      - name: nextToken
-        description: "分页标记，用于获取下一页数据"
-        type: string
-        position: query
-      - name: userId
-        description: "查询者的userId"
+        description: 日程所属的日历ID，统一为primary
+      - name: eventId
         type: string
         required: true
         position: path
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}/attendees?maxResults=Long&nextToken=String
-      method: GET
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 👥 日程参与者列表
-
-        **日程**: {{.eventSummary}}
-        **参与者总数**: {{.totalCount}}人{{if .hasMore}}（显示部分）{{end}}
-
-        {{range $i, $attendee := .attendees}}
-        ## {{add $i 1}}. {{$attendee.displayName}}
-        
-        - 🆔 unionId: {{$attendee.id}}
-        - 📧 邮箱: {{$attendee.email}}
-        - 📱 状态: {{if eq $attendee.responseStatus "accepted"}}✅ 已接受{{else if eq $attendee.responseStatus "declined"}}❌ 已拒绝{{else if eq $attendee.responseStatus "tentative"}}❓ 待定{{else}}⏳ 未回复{{end}}
-        - 👤 类型: {{if $attendee.isOptional}}可选参与者{{else}}必须参与者{{end}}
-        {{if $attendee.comment}}- 💬 备注: {{$attendee.comment}}{{end}}
-        {{if $attendee.isOrganizer}}- 🎯 **组织者**{{end}}
-
-        {{end}}
-
-        {{if .nextToken}}
-        ---
-        **📄 分页信息**: 使用 nextToken "{{.nextToken}}" 获取更多参与者
-        {{end}}
+        description: 日程ID
+      - name: attendeesToAdd
+        type: array
+        required: true
+        position: body
+        description: 需要添加的参与人列表，数组中每个对象包含id（用户unionId）和isOptional（是否可选参与人）字段。示例：[{"id":"unionId123","isOptional":false}]
+      - name: pushNotification
+        type: boolean
+        required: false
+        position: body
+        description: 是否弹窗提醒
+      - name: chatNotification
+        type: boolean
+        required: false
+        position: body
+        description: 是否单聊提醒
 
-  - name: listEvents
-    description: "查询指定时间范围内的日程列表，支持分页和增量同步"
+  - name: removeAttendee
+    description: 删除日程参与者，每次最多支持操作500人
+    requestTemplate:
+      method: POST
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events/{eventId}/attendees/batchRemove
     args:
-      - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
+      - name: unionId
         type: string
         required: true
         position: path
-      - name: maxAttendees
-        description: "每个日程返回的参与者数量上限（默认100）"
-        type: integer
-        position: query
-      - name: maxResults
-        description: "返回的日程数量上限（默认100，最大100）"
-        type: integer
-        position: query
-      - name: nextToken
-        description: "分页标记，用于获取下一页数据"
-        type: string
-        position: query
-      - name: seriesMasterId
-        description: "重复日程的主日程ID，用于查询特定循环日程"
-        type: string
-        position: query
-      - name: showDeleted
-        description: "是否包含已删除的日程"
-        type: boolean
-        position: query
-      - name: syncToken
-        description: "同步标记，用于增量数据同步"
-        type: string
-        position: query
-      - name: timeMax
-        description: "查询结束时间（ISO-8601格式）"
-        type: string
-        position: query
-      - name: timeMin
-        description: "查询开始时间（ISO-8601格式）"
+        description: 日程创建者的unionId
+      - name: calendarId
         type: string
-        position: query
-      - name: userId
-        description: "要查询的userId"
+        required: true
+        position: path
+        description: 日程所属的日历ID，统一为primary
+      - name: eventId
         type: string
         required: true
         position: path
+        description: 日程ID
+      - name: attendeesToRemove
+        type: array
+        required: true
+        position: body
+        description: 需要删除的参与人列表，数组中每个对象包含id（用户unionId）字段。示例：[{"id":"unionId123"}]
+      - name: pushNotification
+        type: boolean
+        required: false
+        position: body
+        description: 是否弹窗提醒
+      - name: chatNotification
+        type: boolean
+        required: false
+        position: body
+        description: 是否单聊提醒
+
+  - name: getAttendees
+    description: 获取日程参与者列表
     requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events?timeMin=String&timeMax=String&showDeleted=Boolean&maxResults=Integer&maxAttendees=Integer&nextToken=String&syncToken=String
       method: GET
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 📋 日程列表
-
-        {{if .events}}
-        **查询时间**: {{if .timeMin}}{{.timeMin | formatTime}}{{else}}不限{{end}} 至 {{if .timeMax}}{{.timeMax | formatTime}}{{else}}不限{{end}}
-        **日程数量**: {{len .events}}个{{if .hasMore}}（显示部分）{{end}}
-
-        {{range $i, $event := .events}}
-        ## {{add $i 1}}. {{$event.summary}}
-
-        - 🆔 ID: {{$event.id}}
-        - ⏰ 时间: {{$event.start.dateTime | formatTime}} - {{$event.end.dateTime | formatTime}}
-        {{if $event.isAllDay}}- 📅 全天日程{{end}}
-        {{if $event.location}}- 📍 地点: {{$event.location.displayName}}{{end}}
-        {{if $event.attendees}}- 👥 参与者: {{len $event.attendees}}人{{end}}
-        {{if $event.recurrenceId}}- 🔄 这是循环日程的实例{{end}}
-        {{if $event.status}}- 📊 状态: {{$event.status}}{{end}}
-
-        {{end}}
-
-        {{if .nextToken}}
-        **📄 分页**: 使用 nextToken "{{.nextToken}}" 获取更多
-        {{end}}
-
-        {{if .syncToken}}
-        **🔄 同步**: 使用 syncToken "{{.syncToken}}" 进行增量同步
-        {{end}}
-
-        {{else}}
-        📭 **暂无日程**
-
-        指定时间范围内没有找到任何日程。
-        {{end}}
-
-  - name: updateEvent
-    description: "修改现有日程的信息，支持更新标题、时间、参与者、地点等任意字段，仅需要组织者权限"
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/events/{eventId}/attendees
     args:
-      - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
+      - name: unionId
         type: string
         required: true
         position: path
-      - name: eventId
-        description: "要修改的日程ID"
+        description: 日程创建者的unionId
+      - name: calendarId
         type: string
         required: true
         position: path
-      - name: userId
-        description: "日程组织者的userId"
+        description: 日程所属的日历ID，统一为primary
+      - name: eventId
         type: string
         required: true
         position: path
-      - name: summary
-        description: "日程标题"
-        type: string
-        position: body
-      - name: description
-        description: "日程描述"
-        type: string
-        position: body
-      - name: start
-        description: "日程开始时间"
-        type: object
-        position: body
-      - name: end
-        description: "日程结束时间"
-        type: object
-        position: body
-      - name: location
-        description: "日程地点"
-        type: object
-        position: body
-      - name: attendees
-        description: "参与者列表"
-        type: array
-        items:
-          type: object
-        position: body
-      - name: isAllDay
-        description: "是否为全天日程"
-        type: boolean
-        position: body
-      - name: reminders
-        description: "提醒设置"
-        type: array
-        items:
-          type: object
-        position: body
-      - name: recurrence
-        description: "重复设置"
-        type: object
-        position: body
-      - name: onlineMeetingInfo
-        description: "在线会议设置"
-        type: object
-        position: body
-      - name: x-client-token
-        description: "幂等性校验令牌"
+        description: 日程ID
+      - name: maxResults
+        type: number
+        required: false
+        position: query
+        description: 最大返回数量，默认100，最大500
+      - name: nextToken
         type: string
-        position: header
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}
-      method: PUT
-      headers:
-        - key: Content-Type
-          value: application/json
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # ✏️ 日程修改结果
-
-        {{if .success}}
-        ✅ **日程修改成功**
-
-        **更新后的日程信息**:
-        - 📅 标题: {{.summary}}
-        - 🆔 日程ID: {{.id}}
-        - ⏰ 开始时间: {{.start.dateTime | formatTime}}
-        - ⏰ 结束时间: {{.end.dateTime | formatTime}}
-        - 📍 类型: {{if .isAllDay}}全天日程{{else}}定时日程{{end}}
-        {{if .description}}
-        - 📝 描述: {{.description}}
-        {{end}}
-        {{if .location}}
-        - 📍 地点: {{.location.displayName}}
-        {{end}}
-
-        **修改的内容**:
-        {{range $change := .changes}}
-        - {{$change.field}}: {{$change.oldValue}} → {{$change.newValue}}
-        {{end}}
-
-        {{if .attendees}}
-        **参与者** ({{len .attendees}}人):
-        {{range $i, $attendee := .attendees}}
-        {{add $i 1}}. {{$attendee.displayName}}{{if $attendee.isOptional}} (可选){{end}}
-        {{end}}
-        {{end}}
-
-        {{if .onlineMeeting}}
-        **在线会议**:
-        - 会议链接: {{.onlineMeeting.joinUrl}}
-        {{end}}
-
-        {{else}}
-        ❌ **日程修改失败** - {{.error}}
-        
-        **错误详情**: {{.errorMessage}}
-        {{end}}
+        required: false
+        position: query
+        description: 分页标记
 
-  - name: removeAttendee
-    description: "从指定日程中移除参与者，支持批量移除多人"
+  - name: getCalendarView
+    description: 查询日程视图，按时间范围获取日程列表
+    requestTemplate:
+      method: GET
+      url: https://api.dingtalk.com/v1.0/calendar/users/{unionId}/calendars/{calendarId}/eventsview
     args:
-      - name: attendeesToRemove
-        description: "需要移除的参与者列表"
-        type: array
-        items:
-          type: object
-        position: body
-      - name: calendarId
-        description: "日历ID，使用'primary'表示主日历"
+      - name: unionId
         type: string
         required: true
         position: path
-      - name: eventId
-        description: "日程ID"
+        description: 用户的unionId
+      - name: calendarId
         type: string
         required: true
         position: path
-      - name: id
-        description: "要移除的用户ID"
+        description: 日程所属的日历ID，统一为primary
+      - name: timeMin
         type: string
-        position: body
-      - name: userId
-        description: "日程创建者的userId"
+        required: true
+        position: query
+        description: 查询的起始时间，RFC3339格式
+      - name: timeMax
         type: string
         required: true
-        position: path
-      - name: x-client-token
-        description: "幂等性校验令牌"
+        position: query
+        description: 查询的结束时间，RFC3339格式
+      - name: maxAttendees
+        type: number
+        required: false
+        position: query
+        description: 返回的参与者列表的最大数量
+      - name: maxResults
+        type: number
+        required: false
+        position: query
+        description: 最大返回数量
+      - name: nextToken
         type: string
-        position: header
-    requestTemplate:
-      url: https://api.dingtalk.com/v1.0/calendar/users/{userId}/calendars/{calendarId}/events/{eventId}/attendees/remove
-      method: POST
-      headers:
-        - key: Content-Type
-          value: application/json
-      security:
-        id: DingTalkAuth
-    responseTemplate:
-      body: |
-        # 👥➖ 日程参与者移除结果
-
-        {{if .success}}
-        ✅ **操作成功** - 已从日程中移除参与者
-
-        **日程信息**:
-        - 日程ID: {{.eventId}}
-        - 操作时间: {{.timestamp}}
-        
-        **移除的参与者**:
-        {{range $i, $attendee := .removedAttendees}}
-        {{add $i 1}}. {{$attendee.displayName}} 
-           - unionId: {{$attendee.id}}
-           - 移除原因: {{$attendee.reason}}
-        {{end}}
-
-        **剩余参与者数量**: {{.remainingCount}}人
-
-        {{if .notifications}}
-        **通知状态**:
-        {{if .notifications.attendeesNotified}}
-        - 已向移除的参与者发送通知
-        {{end}}
-        {{end}}
-
-        {{else}}
-        ❌ **操作失败** - {{.error}}
-        
-        **错误详情**: {{.errorMessage}}
-        {{end}}
-
-
+        required: false
+        position: query
+        description: 分页标记 

package/dist/DingTalkMCPServer.js

@@ -314,6 +314,9 @@ export class DingTalkMCPServer {
                 data: body,
                 timeout: 30000
             });
+            if (this.debug){
+                console.log(response)
+            }
             return {
                 content: [{
                     type: 'text',

package/package.json

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