dingtalk-mcp-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,256 @@
+# 钉钉 MCP Server
+
+[![npm version](https://img.shields.io/npm/v/dingtalk-mcp-server.svg)](https://www.npmjs.com/package/dingtalk-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+让 Claude Code、Cline 等 AI 助手能操作钉钉的 MCP (Model Context Protocol) 服务器。
+
+## ✨ 功能特性
+
+- 📨 **消息管理**: 发送文本消息、发送 Markdown 消息、获取联系人列表
+- ✅ **待办管理**: 创建待办事项、查询待办列表、更新待办状态
+- 📅 **日程管理**: 创建日程、查询日程列表
+
+## 📦 安装
+
+### npm 安装（推荐）
+
+```bash
+npm install dingtalk-mcp-server
+```
+
+### 源码安装
+
+```bash
+git clone https://github.com/yourusername/dingtalk-mcp-server.git
+cd dingtalk-mcp-server
+npm install
+npm run build
+```
+
+## ⚙️ 配置
+
+### 1. 创建钉钉应用
+
+1. 登录 [钉钉开发者平台](https://open.dingtalk.com/)
+2. 创建企业内部应用
+3. 获取应用的 `AppKey`、`AppSecret`、`AgentId`
+4. 配置应用权限：
+   - `contact:read` - 读取通讯录
+   - `chat:write` - 发送消息
+   - `todo:write` - 待办管理
+   - `calendar:write` - 日程管理
+
+### 2. Claude Code 配置
+
+在 Claude Code 的 `settings.json` 中添加 MCP 服务器配置：
+
+**方式一：全局安装后使用**
+
+```json
+{
+  "mcpServers": {
+    "dingtalk": {
+      "command": "npx",
+      "args": ["dingtalk-mcp-server"],
+      "env": {
+        "DINGTALK_APP_KEY": "your_app_key",
+        "DINGTALK_APP_SECRET": "your_app_secret",
+        "DINGTALK_AGENT_ID": "your_agent_id"
+      }
+    }
+  }
+}
+```
+
+**方式二：本地路径**
+
+```json
+{
+  "mcpServers": {
+    "dingtalk": {
+      "command": "node",
+      "args": ["/path/to/dingtalk-mcp-server/dist/index.js"],
+      "env": {
+        "DINGTALK_APP_KEY": "your_app_key",
+        "DINGTALK_APP_SECRET": "your_app_secret",
+        "DINGTALK_AGENT_ID": "your_agent_id"
+      }
+    }
+  }
+}
+```
+
+### 3. Cline / VS Code 配置
+
+在 VS Code 的 MCP 配置中添加：
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "dingtalk": {
+        "command": "npx",
+        "args": ["dingtalk-mcp-server"],
+        "env": {
+          "DINGTALK_APP_KEY": "your_app_key",
+          "DINGTALK_APP_SECRET": "your_app_secret",
+          "DINGTALK_AGENT_ID": "your_agent_id"
+        }
+      }
+    }
+  }
+}
+```
+
+## 🛠️ 可用工具
+
+### 消息工具
+
+| 工具名称 | 描述 | 参数 |
+|---------|------|------|
+| `dingtalk_message_send_text` | 发送文本消息 | `userid`, `content` |
+| `dingtalk_message_send_markdown` | 发送 Markdown 消息 | `userid`, `title`, `content` |
+| `dingtalk_message_get_contacts` | 获取联系人列表 | 无 |
+
+### 待办工具
+
+| 工具名称 | 描述 | 参数 |
+|---------|------|------|
+| `dingtalk_todo_create` | 创建待办事项 | `subject`, `executorUserIds`, `description?`, `dueTime?`, `participantUserIds?` |
+| `dingtalk_todo_list` | 获取待办列表 | `userid`, `status?` |
+| `dingtalk_todo_update` | 更新待办状态 | `recordId`, `status` |
+
+### 日程工具
+
+| 工具名称 | 描述 | 参数 |
+|---------|------|------|
+| `dingtalk_calendar_create` | 创建日程 | `summary`, `startTime`, `endTime`, `organizerUserid`, `attendeeUserids`, `description?`, `location?`, `reminder?` |
+| `dingtalk_calendar_list` | 获取日程列表 | `userid`, `startTime`, `endTime` |
+
+## 📝 使用示例
+
+### 在 Claude Code 中使用
+
+```
+用户: 帮我给张三发一条钉钉消息，告诉他明天开会
+Claude: 我来帮您发送钉钉消息。
+
+[调用 dingtalk_message_send_text 工具]
+参数:
+- userid: "zhangsan"
+- content: "明天有会议，请注意时间安排"
+
+消息已成功发送给张三！
+
+用户: 帮我创建一个待办，标题是"完成项目报告"，截止时间是明天
+Claude: 我来帮您创建待办事项。
+
+[调用 dingtalk_todo_create 工具]
+参数:
+- subject: "完成项目报告"
+- dueTime: 1711276800 (明天的 Unix 时间戳)
+- executorUserIds: ["your_userid"]
+
+待办已创建成功！
+```
+
+### 代码示例
+
+```typescript
+import { DingTalkAPI } from 'dingtalk-mcp-server';
+
+const api = new DingTalkAPI(
+  process.env.DINGTALK_APP_KEY!,
+  process.env.DINGTALK_APP_SECRET!,
+  process.env.DINGTALK_AGENT_ID!
+);
+
+// 发送消息
+await api.sendTextMessage('userid', '你好，这是测试消息');
+
+// 创建待办
+await api.createTodo({
+  subject: '完成项目报告',
+  executorUserIds: ['userid'],
+  dueTime: Math.floor(Date.now() / 1000) + 86400, // 明天
+});
+
+// 创建日程
+await api.createCalendarEvent({
+  summary: '项目评审会议',
+  startTime: Math.floor(Date.now() / 1000) + 3600, // 1小时后
+  endTime: Math.floor(Date.now() / 1000) + 7200,   // 2小时后
+  organizerUserid: 'userid',
+  attendeeUserids: ['user1', 'user2'],
+  location: '会议室A',
+});
+```
+
+## 🔐 钉钉 API 权限
+
+使用此 MCP 服务器需要以下钉钉应用权限：
+
+| 权限 | 用途 |
+|------|------|
+| `contact:read` | 读取通讯录，获取联系人列表 |
+| `chat:write` | 发送消息给用户 |
+| `todo:write` | 创建和管理待办事项 |
+| `calendar:write` | 创建和管理日程 |
+
+## 🔧 开发
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式（监听文件变化）
+npm run dev
+
+# 构建
+npm run build
+
+# 运行
+npm start
+```
+
+## 📋 环境变量
+
+| 变量名 | 描述 | 必填 |
+|--------|------|------|
+| `DINGTALK_APP_KEY` | 钉钉应用的 AppKey | ✅ |
+| `DINGTALK_APP_SECRET` | 钉钉应用的 AppSecret | ✅ |
+| `DINGTALK_AGENT_ID` | 钉钉应用的 AgentId | ✅ |
+
+## 🐛 常见问题
+
+### Q: 发送消息失败？
+
+检查以下几点：
+1. 应用权限是否正确配置
+2. 用户是否在应用可见范围内
+3. AppKey、AppSecret、AgentId 是否正确
+
+### Q: 获取联系人列表为空？
+
+确保应用有 `contact:read` 权限，并且通讯录可见范围设置正确。
+
+### Q: 如何获取用户 ID？
+
+可以通过以下方式获取：
+1. 在钉钉管理后台查看
+2. 使用 `getUserId` 方法通过免登码获取
+
+## 📄 License
+
+MIT License - 详见 [LICENSE](LICENSE) 文件
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 📚 相关链接
+
+- [钉钉开放平台](https://open.dingtalk.com/)
+- [MCP 协议文档](https://modelcontextprotocol.io/)
+- [Claude Code 文档](https://docs.anthropic.com/claude-code)

package/dist/handlers/calendar.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 日程处理器
+ */
+import { DingTalkAPI } from '../utils/dingtalk.js';
+import { calendarTools } from '../tools/calendar.js';
+export { calendarTools };
+export declare function handleCalendar(dingtalk: DingTalkAPI, name: string, args: any): Promise<any>;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/handlers/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/handlers/calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,wBAAsB,cAAc,CAClC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,GAAG,CAAC,CA6Cd"}

package/dist/handlers/calendar.js

@@ -0,0 +1,44 @@
+/**
+ * 日程处理器
+ */
+import { calendarTools } from '../tools/calendar.js';
+export { calendarTools };
+export async function handleCalendar(dingtalk, name, args) {
+    switch (name) {
+        case 'dingtalk_calendar_create': {
+            const result = await dingtalk.createCalendarEvent({
+                summary: args.summary,
+                description: args.description,
+                startTime: args.startTime,
+                endTime: args.endTime,
+                organizerUserid: args.organizerUserid,
+                attendeeUserids: args.attendeeUserids,
+                location: args.location,
+                reminder: args.reminder,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `日程创建成功\n日程ID: ${result.event_id}`,
+                    },
+                ],
+            };
+        }
+        case 'dingtalk_calendar_list': {
+            const events = await dingtalk.getCalendarEvents(args.userid, args.startTime, args.endTime);
+            const eventList = events.map((e) => `- ${e.summary}\n  时间: ${new Date(e.start_time * 1000).toLocaleString()} - ${new Date(e.end_time * 1000).toLocaleString()}\n  地点: ${e.location || '无'}`).join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `日程列表:\n${eventList || '暂无日程'}`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`未知日程工具: ${name}`);
+    }
+}
+//# sourceMappingURL=calendar.js.map

package/dist/handlers/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/handlers/calendar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAqB,EACrB,IAAY,EACZ,IAAS;IAET,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,0BAA0B,CAAC,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC;gBAChD,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iBAAiB,MAAM,CAAC,QAAQ,EAAE;qBACzC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,iBAAiB,CAC7C,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,OAAO,CACb,CAAC;YACF,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CACtC,KAAK,CAAC,CAAC,OAAO,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,QAAQ,IAAI,GAAG,EAAE,CACxJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,SAAS,IAAI,MAAM,EAAE;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/handlers/messages.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 消息处理器
+ */
+import { DingTalkAPI } from '../utils/dingtalk.js';
+import { messageTools } from '../tools/messages.js';
+export { messageTools };
+export declare function handleMessages(dingtalk: DingTalkAPI, name: string, args: any): Promise<any>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/handlers/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/handlers/messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,wBAAsB,cAAc,CAClC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,GAAG,CAAC,CAgDd"}

package/dist/handlers/messages.js

@@ -0,0 +1,46 @@
+/**
+ * 消息处理器
+ */
+import { messageTools } from '../tools/messages.js';
+export { messageTools };
+export async function handleMessages(dingtalk, name, args) {
+    switch (name) {
+        case 'dingtalk_message_send_text': {
+            const result = await dingtalk.sendTextMessage(args.userid, args.content);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `消息发送成功\n任务ID: ${result.task_id}`,
+                    },
+                ],
+            };
+        }
+        case 'dingtalk_message_send_markdown': {
+            const result = await dingtalk.sendMarkdownMessage(args.userid, args.title, args.content);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Markdown消息发送成功\n任务ID: ${result.task_id}`,
+                    },
+                ],
+            };
+        }
+        case 'dingtalk_message_get_contacts': {
+            const contacts = await dingtalk.getContacts();
+            const contactList = contacts.map((c) => `- ${c.name} (${c.userid})`).join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `联系人列表:\n${contactList}`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`未知消息工具: ${name}`);
+    }
+}
+//# sourceMappingURL=messages.js.map

package/dist/handlers/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/handlers/messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAqB,EACrB,IAAY,EACZ,IAAS;IAET,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,4BAA4B,CAAC,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iBAAiB,MAAM,CAAC,OAAO,EAAE;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,gCAAgC,CAAC,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAC/C,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,OAAO,CACb,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yBAAyB,MAAM,CAAC,OAAO,EAAE;qBAChD;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,+BAA+B,CAAC,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAC1C,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,CAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW,WAAW,EAAE;qBAC/B;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/handlers/todo.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 待办处理器
+ */
+import { DingTalkAPI } from '../utils/dingtalk.js';
+import { todoTools } from '../tools/todo.js';
+export { todoTools };
+export declare function handleTodo(dingtalk: DingTalkAPI, name: string, args: any): Promise<any>;
+//# sourceMappingURL=todo.d.ts.map

package/dist/handlers/todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../src/handlers/todo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,GAAG,CAAC,CAkDd"}

package/dist/handlers/todo.js

@@ -0,0 +1,52 @@
+/**
+ * 待办处理器
+ */
+import { todoTools } from '../tools/todo.js';
+export { todoTools };
+export async function handleTodo(dingtalk, name, args) {
+    switch (name) {
+        case 'dingtalk_todo_create': {
+            const result = await dingtalk.createTodo({
+                subject: args.subject,
+                description: args.description,
+                dueTime: args.dueTime,
+                executorUserIds: args.executorUserIds,
+                participantUserIds: args.participantUserIds,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `待办创建成功\n记录ID: ${result.record_id}`,
+                    },
+                ],
+            };
+        }
+        case 'dingtalk_todo_list': {
+            const todos = await dingtalk.getTodoList(args.userid, args.status);
+            const todoList = todos.map((t) => `- [${t.status === 1 ? '✓' : ' '}] ${t.title} (ID: ${t.record_id})`).join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `待办列表:\n${todoList || '暂无待办'}`,
+                    },
+                ],
+            };
+        }
+        case 'dingtalk_todo_update': {
+            const result = await dingtalk.updateTodo(args.recordId, args.status);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `待办状态已更新`,
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`未知待办工具: ${name}`);
+    }
+}
+//# sourceMappingURL=todo.js.map

package/dist/handlers/todo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.js","sourceRoot":"","sources":["../../src/handlers/todo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAqB,EACrB,IAAY,EACZ,IAAS;IAET,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;aAC5C,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,iBAAiB,MAAM,CAAC,SAAS,EAAE;qBAC1C;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CACpC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,CACpE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,QAAQ,IAAI,MAAM,EAAE;qBACrC;iBACF;aACF,CAAC;QACJ,CAAC;QAED,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACrE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS;qBAChB;iBACF;aACF,CAAC;QACJ,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * 钉钉MCP服务器入口
+ *
+ * 让Claude Code能操作钉钉（消息/待办/日程）
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+/**
+ * 钉钉MCP服务器入口
+ *
+ * 让Claude Code能操作钉钉（消息/待办/日程）
+ */
+import { DingTalkMCPServer } from './server.js';
+async function main() {
+    const server = new DingTalkMCPServer();
+    await server.run();
+}
+main().catch((error) => {
+    console.error('服务器启动失败:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;IACvC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;AACrB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 钉钉MCP服务器实现
+ */
+export declare class DingTalkMCPServer {
+    private server;
+    private dingtalk;
+    constructor();
+    private setupHandlers;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAc;;IAyB9B,OAAO,CAAC,aAAa;IAqFf,GAAG;CAKV"}

package/dist/server.js

@@ -0,0 +1,110 @@
+/**
+ * 钉钉MCP服务器实现
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { DingTalkAPI } from './utils/dingtalk.js';
+import { messageTools, handleMessages } from './handlers/messages.js';
+import { todoTools, handleTodo } from './handlers/todo.js';
+import { calendarTools, handleCalendar } from './handlers/calendar.js';
+export class DingTalkMCPServer {
+    server;
+    dingtalk;
+    constructor() {
+        this.server = new Server({
+            name: 'dingtalk-mcp-server',
+            version: '0.1.0',
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+            },
+        });
+        this.dingtalk = new DingTalkAPI(process.env.DINGTALK_APP_KEY || '', process.env.DINGTALK_APP_SECRET || '', process.env.DINGTALK_AGENT_ID || '');
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // 列出工具
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    ...messageTools,
+                    ...todoTools,
+                    ...calendarTools,
+                ],
+            };
+        });
+        // 调用工具
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            // 根据工具名称前缀分发
+            if (name.startsWith('dingtalk_message')) {
+                return handleMessages(this.dingtalk, name, args);
+            }
+            else if (name.startsWith('dingtalk_todo')) {
+                return handleTodo(this.dingtalk, name, args);
+            }
+            else if (name.startsWith('dingtalk_calendar')) {
+                return handleCalendar(this.dingtalk, name, args);
+            }
+            throw new Error(`未知工具: ${name}`);
+        });
+        // 列出资源
+        this.server.setRequestHandler(ListResourcesRequestSchema, async () => {
+            return {
+                resources: [
+                    {
+                        uri: 'dingtalk://conversations',
+                        name: '钉钉会话列表',
+                        mimeType: 'application/json',
+                    },
+                    {
+                        uri: 'dingtalk://contacts',
+                        name: '钉钉联系人',
+                        mimeType: 'application/json',
+                    },
+                ],
+            };
+        });
+        // 读取资源
+        this.server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+            const { uri } = request.params;
+            if (uri === 'dingtalk://conversations') {
+                const conversations = await this.dingtalk.getConversations();
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(conversations, null, 2),
+                        },
+                    ],
+                };
+            }
+            if (uri === 'dingtalk://contacts') {
+                const contacts = await this.dingtalk.getContacts();
+                return {
+                    contents: [
+                        {
+                            uri,
+                            mimeType: 'application/json',
+                            text: JSON.stringify(contacts, null, 2),
+                        },
+                    ],
+                };
+            }
+            throw new Error(`未知资源: ${uri}`);
+        });
+        // 错误处理
+        this.server.onerror = (error) => {
+            console.error('[MCP Error]', error);
+        };
+    }
+    async run() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('钉钉MCP服务器已启动');
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}