Dingtalk Wiki MCP

dingtalk维基mcp

   

钉Wiki/Docs读写MCP服务器，填补钉官方MCP留下的空白。

中文文档 / Chinese docs

钉钉官方MCP 不 提供Wiki/Docs读写功能。\ 该项目是一个开源补充，使AI代理和MCP客户端能够 阅读、浏览和创建DingTalk Wiki/Docs内容.

存储库亮点

• 官方MCP缺口：Wiki/Docs读写不包括在内
• 此项目添加了它：工作区浏览、节点浏览和文档创建
• MCP兼容：适用于基于stdio的MCP客户端
• 代理就绪：包括 SKILL.md 适用于OpenClaw风格的技能工作流程

______________________________________________________________________

快速开始

1） 安装

npm install

2） 配置环境

cp .env.example .env

必修的：

DINGTALK_APP_KEY=your-app-key
DINGTALK_APP_SECRET=your-app-secret

index.js 现在自动加载 .env 如果这些变量在环境中不存在，则从当前工作目录（或repo目录）中删除。

3） 准备本地配置

cp config.example.json config.json

4） 快跑

npm start

或者：

node index.js

npx dingtalk-wiki-mcp 是npm发布后的一条未来友好之路。\ 此存储库已包含正确的CLI条目(bin)，但npm发行版还不是当前版本的一部分。

______________________________________________________________________

钉官方MCP与该项目

定位原则： 这个项目确实 不 取代官方的钉钉MCP。它 补充物 通过填补Wiki/Docs的空白。

______________________________________________________________________

核心能力

维基/文档

• 列出Wiki工作区
• 获取工作区详细信息
• 列出Wiki节点（文件夹/文档）
• 创建：

- DOC - WORKBOOK - MIND - FOLDER

• 通过链接到钉搜索来搜索Wiki
• 阅读值得注意/ .able 通过官方API提供的表格和记录

组织

• 列出部门
• 列出部门用户
• 获取用户信息

操作员/配置

• 设置当前操作员(unionId)
• 使用本地配置中的默认运算符
• 检查当前本地配置

技能包括

此仓库不仅是MCP服务器。它还包括：

• SKILL.md

因此，它可以重复使用作为 技能包 在OpenClaw风格的代理工作流程中。

______________________________________________________________________

演示

1.列出Wiki工作区

List workspaces demo

2.浏览工作区节点

3.创建文档

Create document demo

这些演示图像是从代表性命令/输出流构建的说明性文档资产，删除了所有租户特定的数据。

______________________________________________________________________

实际使用案例

1） AI自动创建周报文档

您的AI代理可以每周创建一个新的DingTalk Wiki文档，用于销售、产品或运营报告。

2） Agent在编写之前探索Wiki结构

在生成内容之前，代理可以先检查工作区和文件夹，然后选择正确的目标节点。

3） 自动初始化项目知识库结构

当一个新项目开始时，自动化可以创建一个标准的文件夹树，例如：

• 项目概述
• 周报
• 规格
• 发布说明
• 回顾

______________________________________________________________________

客户端集成示例

• OpenClaw示例
• 麦克波特示例
• 通用MCP客户端示例

______________________________________________________________________

示例用法

注册服务器模式

如果您已在MCP客户端配置中以以下名称注册了此服务器 dingtalk-wiki:

mcporter call dingtalk-wiki.show_config
mcporter call dingtalk-wiki.list_wiki_workspaces
mcporter call dingtalk-wiki.list_wiki_nodes workspace_id="your_workspace_id"
mcporter call dingtalk-wiki.create_wiki_doc workspace_id="your_workspace_id" name="Weekly Summary" doc_type="DOC"
mcporter call dingtalk-wiki.get_user_info userid="your_user_id"

直接输入模式

如果您想直接运行服务器而不预先注册，请直接调用工具名称：

mcporter call --stdio "node ./index.js" show_config
mcporter call --stdio "node ./index.js" list_wiki_workspaces
mcporter call --stdio "node ./index.js" list_wiki_nodes workspace_id="your_workspace_id"
mcporter call --stdio "node ./index.js" create_wiki_doc workspace_id="your_workspace_id" name="Weekly Summary" doc_type="DOC"

______________________________________________________________________

可用的MCP工具

• set_operator
• show_config
• list_wiki_workspaces
• get_wiki_workspace
• list_wiki_nodes
• get_wiki_node
• create_wiki_doc
• search_wiki
• list_departments
• get_department_users
• get_user_info
• list_notable_sheets
• list_notable_records

______________________________________________________________________

需求

• Node.js 18+
• 具有所需API权限的DingTalk应用程序
• 与stdio兼容的MCP客户端，例如：

- 龙虾 - 麦波特 - 其他MCP主机/客户端

______________________________________________________________________

权限

根据您的使用情况，您的钉钉应用程序可能需要以下权限：

• Document.WorkspaceDocument.Write
• Wiki读取权限
• 部门读取权限
• 用户读取权限

有关最新的权限名称和审批要求，请参阅钉钉开放平台文档。

______________________________________________________________________

信托材料

• 常见问题解答
• 更新日志
• API测试说明
• 技能定义

______________________________________________________________________

安全说明

• config.json 包含本地用户和工作区元数据，因此 不要承诺
• 此存储库已忽略 config.json 和 .env
• 通过环境变量注入AppKey/AppSecret，而不是对其进行硬编码

______________________________________________________________________

局限性

• 这是一个社区维护的补充，而不是官方的钉钉项目
• 一些API需要钉端的企业批准
• search_wiki 目前，它更像是一个搜索条目助手，而不是全文搜索实现
• 通过官方公共API读取正常的DingTalk文档正文内容在本项目中仍未实现
• 值得注意/ .able 目前支持的是工作表和记录，而不是任意的文档正文导出

______________________________________________________________________

相关链接

• 钉钉开放平台-知识库概述
• 创建团队空间文档

______________________________________________________________________

许可证

麻省理工学院