钉钉文档解析

🚀 釘釘文檔解析 MCP 服務器

🎯 這是一個用於解析釘釘文檔內容並生成 HTML 的 MCP (Model Context Protocol) 服務器，能幫助你高效處理釘釘文檔。

✨ 主要特性

• 🔐 完整解析流程：通過 GET 請求提取 dentryKey，再進行 POST 請求，最終生成 HTML。
• 📊 多元素支持：支持解析段落、表格、圖片、代碼塊、富文本等多種文檔元素。
• 🎨 美觀渲染：採用漸變色 UI 和深色代碼主題，呈現美觀的視覺效果。
• 📋 代碼複製：代碼塊支持一鍵複製，方便用戶操作。
• 🌐 靈活輸入：既支持輸入完整的文檔 URL，也支持輸入 NODE_ID。
• 📁 智能歸檔：可按文檔標題自動創建文件夾，便於管理。
• 🍪 智能 Cookie 管理：Node.js 版本可自動檢測 Cookie 失效並引導用戶登錄。

🚀 快速開始

本項目提供 Python 和 Node.js 兩個版本，功能相同，你可根據自己的技術棧進行選擇。

📁 目錄結構

mcp-dingtalk-doc/
├── README.md              # 本文件
├── .gitignore            # Git 忽略配置
├── mcp_config_example.json  # 配置示例
├── python/               # Python 版本 🐍
│   ├── server.py         # MCP 服務器
│   ├── cookie_manager.py # Cookie 管理
│   ├── pyproject.toml    # 項目配置
│   ├── requirements.txt  # 依賴列表
│   └── README.md         # Python 版本文檔
└── nodejs/               # Node.js/TypeScript 版本 ⚡
    ├── src/              # TypeScript 源碼
    │   ├── index.ts      # MCP 服務器入口
    │   ├── cookie-manager.ts  # Cookie 管理
    │   ├── smart-cookie.ts    # 智能 Cookie
    │   └── ...
    ├── dist/             # 編譯後的 JS
    ├── package.json      # 項目配置
    ├── tsconfig.json     # TypeScript 配置
    └── README.md         # Node.js 版本文檔

選擇版本

🐍 Python 版本 - 查看詳細文檔

# 1. 進入 Python 目錄
cd python

# 2. 安裝依賴
pip install -e .

# 3. 配置 Cookie（環境變量）
export DINGTALK_COOKIE="your_cookie_here"

# 4. 配置 MCP
# 編輯 ~/.cursor/mcp.json 或 %APPDATA%\Cursor\mcp.json

⚡ Node.js 版本 - 查看詳細文檔 (推薦)

# 1. 進入 Node.js 目錄
cd nodejs

# 2. 安裝依賴
npm install

# 3. 構建項目
npm run build

# 4. 自動登錄獲取 Cookie（推薦）
npm run cookie:login
# 瀏覽器會自動打開，掃碼登錄後自動保存 Cookie

# 5. 配置 MCP
# 編輯 ~/.cursor/mcp.json 或 %APPDATA%\Cursor\mcp.json

💻 使用示例

在 Cursor 中使用

配置完成後，在 Cursor 聊天框中直接輸入：

請幫我解析這個釘釘文檔：
https://alidocs.dingtalk.com/i/nodes/Y1OQX0akWm3ZoLgLhADaaXPMJGlDd3mE

AI 會自動調用 MCP 工具解析文檔！

可用工具

1. parse_document - 完整解析並保存

解析釘釘文檔，提取內容並生成 HTML 文件。

參數：

• url_or_node_id (必需)：釘釘文檔 URL 或 NODE_ID
• cookie (可選)：Cookie，未提供則使用環境變量或自動登錄
• save_files (可選)：是否保存文件，默認 true
• output_dir (可選)：輸出目錄路徑

示例：

{
  "url_or_node_id": "https://alidocs.dingtalk.com/i/nodes/xxx",
  "save_files": true
}

輸出：

~/Documents/cursor-mcp/dingDoc/文檔標題/
├── {NODE_ID}_mainsite.json      # GET 請求數據
├── {NODE_ID}_document.json      # POST 請求數據
├── {NODE_ID}_content.json       # 文檔詳細內容
└── {NODE_ID}.html               # 生成的 HTML ⭐

2. get_html - 快速獲取 HTML

快速獲取 HTML 內容（不保存文件）。

參數：

• url_or_node_id (必需)：釘釘文檔 URL 或 NODE_ID
• cookie (可選)：Cookie

📚 詳細文檔

支持的文檔元素

HTML 樣式特點

• 🌈 漸變色背景（紫色系）
• 📱 響應式設計，支持移動端
• 💻 深色代碼主題（VS Code Dark+）
• ✨ 流暢動畫效果
• 📋 代碼塊一鍵複製
• 🖼️ 圖片自適應顯示

版本對比詳情

Python 版本優勢

• ✅ 成熟穩定，已在多個項目中使用
• ✅ Python 生態豐富，易於擴展
• ✅ 適合 Python 技術棧的團隊
• ✅ 依賴簡單，安裝快速

Node.js 版本優勢

• ⚡ 啟動速度快 5 倍（100ms vs 500ms）
• 📦 包體積小 40%（30MB vs 50MB）
• 🔥 智能 Cookie 管理：自動檢測失效並引導登錄
• 🌐 Playwright 自動登錄：無需手動複製 Cookie
• 💾 Cookie 持久化：7 - 30 天內無需重新登錄
• ✅ MCP 官方 SDK：更好的兼容性和支持
• 🎯 TypeScript 類型安全：更少的運行時錯誤
• ⚡ 原生異步：性能更優

Cookie 管理對比

Python 版本

# 手動獲取 Cookie
# 1. 瀏覽器打開釘釘文檔
# 2. F12 → Network → 複製 Cookie
# 3. 設置環境變量
export DINGTALK_COOKIE="your_cookie"

Node.js 版本（智能管理）

# 方式 1：自動登錄（推薦）
npm run cookie:login
# 瀏覽器自動打開 → 掃碼登錄 → 自動保存 ✅

# 方式 2：智能獲取
npm run cookie:auto
# 如果 Cookie 有效就用現有的，無效則自動登錄 ✅

# 方式 3：檢查有效性
npm run cookie:check

配置示例

Python 版本配置

{
  "mcpServers": {
    "dingtalk-doc-python": {
      "command": "python",
      "args": ["C:/path/to/python/server.py"],
      "env": {
        "DINGTALK_COOKIE": "your_cookie"
      }
    }
  }
}

Node.js 版本配置

{
  "mcpServers": {
    "dingtalk-doc-nodejs": {
      "command": "node",
      "args": ["C:/path/to/nodejs/dist/index.js"],
      "env": {
        "DINGTALK_COOKIE": "your_cookie (可選，會自動登錄)"
      }
    }
  }
}

🔧 技術細節

已知限制

• ⚠️ OSS 加密的文檔內容暫不支持完整解密
• ⚠️ 部分特殊元素（列表、引用塊等）待支持
• ⚠️ Cookie 會過期（Python 版本需要手動更新，Node.js 版本會自動處理）

更新日誌

v2.0.0 (2025-12-01) - Node.js 版本

• ✅ 新增 Node.js/TypeScript 實現
• 🔥 智能 Cookie 管理（自動檢測失效並引導登錄）
• 🌐 Playwright 自動登錄支持
• ⚡ 啟動速度提升 5 倍
• 📦 包體積減少 40%
• 🎯 TypeScript 類型安全
• ✅ MCP 官方 SDK

v1.0.0 (2025-11-03) - Python 版本

• ✅ 初始版本（Python）
• ✅ 支持文檔解析和 HTML 生成
• ✅ 支持 5 種文檔元素
• ✅ 代碼塊一鍵複製功能

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

兩個版本都需要維護，如果你：

• 熟悉 Python → 可以改進 Python 版本
• 熟悉 Node.js/TypeScript → 可以改進 Node.js 版本

📄 許可證

MIT License - 本項目僅供學習和研究使用。

👨‍💻 作者

• 原作者：黃雲堃 (Yunkun Huang) - Python 版本
• Node.js 版本：shinjiyu - TypeScript 重寫 + 智能 Cookie 管理

🔗 相關鏈接

• Model Context Protocol
• 釘釘文檔
• MCP SDK (Python)
• MCP SDK (Node.js)

快速開始：選擇你喜歡的版本 → 查看對應的 README → 安裝配置 → 使用！🚀