钉钉文档解析

🚀 DingTalk Document Parsing MCP Server

An MCP (Model Context Protocol) server for parsing DingTalk document content and generating HTML.

✨ Features

• 🔐 Complete Parsing Process: GET → Extract dentryKey → POST → Generate HTML
• 📊 Multi-Element Support: Paragraphs, tables, images, code blocks, and rich text
• 🎨 Beautiful Rendering: Gradient color UI + Dark code theme
• 📋 Code Copying: One-click copy for code blocks
• 🌐 Flexible Input: Supports full URLs or NODE_ID
• 📁 Intelligent Archiving: Automatically creates folders by document title
• 🍪 Intelligent Cookie Management: Automatically detects invalidation and guides login (Node.js version)

🚀 Two Versions

This project offers implementations in both Python and Node.js, with identical functionality. You can choose based on your technology stack:

📁 Directory Structure

mcp-dingtalk-doc/
├── README.md              # This file
├── .gitignore            # Git ignore configuration
├── mcp_config_example.json  # Configuration example
├── python/               # Python version 🐍
│   ├── server.py         # MCP server
│   ├── cookie_manager.py # Cookie management
│   ├── pyproject.toml    # Project configuration
│   ├── requirements.txt  # Dependency list
│   └── README.md         # Python version documentation
└── nodejs/               # Node.js/TypeScript version ⚡
    ├── src/              # TypeScript source code
    │   ├── index.ts      # MCP server entry
    │   ├── cookie-manager.ts  # Cookie management
    │   ├── smart-cookie.ts    # Intelligent Cookie
    │   └── ...
    ├── dist/             # Compiled JS
    ├── package.json      # Project configuration
    ├── tsconfig.json     # TypeScript configuration
    └── README.md         # Node.js version documentation

🚀 Quick Start

Choose a Version

🐍 Python Version - View Detailed Documentation

# 1. Navigate to the Python directory
cd python

# 2. Install dependencies
pip install -e .

# 3. Configure the Cookie (environment variable)
export DINGTALK_COOKIE="your_cookie_here"

# 4. Configure MCP
# Edit ~/.cursor/mcp.json or %APPDATA%\Cursor\mcp.json

⚡ Node.js Version - View Detailed Documentation (Recommended)

# 1. Navigate to the Node.js directory
cd nodejs

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Automatically log in to obtain the Cookie (Recommended)
npm run cookie:login
# The browser will automatically open. After scanning the code to log in, the Cookie will be automatically saved.

# 5. Configure MCP
# Edit ~/.cursor/mcp.json or %APPDATA%\Cursor\mcp.json

💻 Usage Examples

Use in Cursor

After configuration, simply say in the Cursor chat box:

Please help me parse this DingTalk document:
https://alidocs.dingtalk.com/i/nodes/Y1OQX0akWm3ZoLgLhADaaXPMJGlDd3mE

The AI will automatically call the MCP tool to parse the document!

Available Tools

1. parse_document - Complete Parsing and Saving

Parse a DingTalk document, extract the content, and generate an HTML file.

Parameters:

• url_or_node_id (Required): DingTalk document URL or NODE_ID
• cookie (Optional): Cookie. If not provided, the environment variable or automatic login will be used.
• save_files (Optional): Whether to save the files. Default is true.
• output_dir (Optional): Output directory path

Example:

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

Output:

~/Documents/cursor-mcp/dingDoc/Document Title/
├── {NODE_ID}_mainsite.json      # GET request data
├── {NODE_ID}_document.json      # POST request data
├── {NODE_ID}_content.json       # Detailed document content
└── {NODE_ID}.html               # Generated HTML ⭐

2. get_html - Quickly Obtain HTML

Quickly obtain the HTML content (without saving the file).

Parameters:

• url_or_node_id (Required): DingTalk document URL or NODE_ID
• cookie (Optional): Cookie

📚 Documentation

Supported Document Elements

HTML Style Features

• 🌈 Gradient background (purple series)
• 📱 Responsive design, supporting mobile devices
• 💻 Dark code theme (VS Code Dark+)
• ✨ Smooth animation effects
• 📋 One-click copy for code blocks
• 🖼️ Adaptive image display

Version Comparison Details

Python Version Advantages

• ✅ Mature and stable, used in multiple projects
• ✅ Rich Python ecosystem, easy to expand
• ✅ Suitable for teams with a Python technology stack
• ✅ Simple dependencies, fast installation

Node.js Version Advantages

• ⚡ 5x faster startup speed (100ms vs 500ms)
• 📦 40% smaller package size (30MB vs 50MB)
• 🔥 Intelligent Cookie management: Automatically detects invalidation and guides login
• 🌐 Playwright automatic login: No need to manually copy the Cookie
• 💾 Cookie persistence: No need to log in again within 7 - 30 days
• ✅ Official MCP SDK: Better compatibility and support
• 🎯 TypeScript type safety: Fewer runtime errors
• ⚡ Native asynchronous: Better performance

Cookie Management Comparison

Python Version

# Manually obtain the Cookie
# 1. Open the DingTalk document in the browser
# 2. F12 → Network → Copy the Cookie
# 3. Set the environment variable
export DINGTALK_COOKIE="your_cookie"

Node.js Version (Intelligent Management)

# Method 1: Automatic login (Recommended)
npm run cookie:login
# The browser automatically opens → Scan the code to log in → Automatically save ✅

# Method 2: Intelligent acquisition
npm run cookie:auto
# If the Cookie is valid, use the existing one. If invalid, automatically log in ✅

# Method 3: Check validity
npm run cookie:check

Configuration Examples

Python Version Configuration

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

Node.js Version Configuration

{
  "mcpServers": {
    "dingtalk-doc-nodejs": {
      "command": "node",
      "args": ["C:/path/to/nodejs/dist/index.js"],
      "env": {
        "DINGTALK_COOKIE": "your_cookie (Optional, will automatically log in)"
      }
    }
  }
}

🔧 Technical Details

Known Limitations

• ⚠️ Currently, full decryption of OSS-encrypted document content is not supported.
• ⚠️ Support for some special elements (such as lists and quote blocks) is pending.
• ⚠️ Cookies will expire (The Python version requires manual update, while the Node.js version handles it automatically).

Update Log

v2.0.0 (2025-12-01) - Node.js Version

• ✅ New Node.js/TypeScript implementation
• 🔥 Intelligent Cookie management (Automatically detects invalidation and guides login)
• 🌐 Playwright automatic login support
• ⚡ 5x faster startup speed
• 📦 40% smaller package size
• 🎯 TypeScript type safety
• ✅ Official MCP SDK

v1.0.0 (2025-11-03) - Python Version

• ✅ Initial version (Python)
• ✅ Supports document parsing and HTML generation
• ✅ Supports 5 types of document elements
• ✅ One-click copy function for code blocks

🤝 Contribution

Welcome to submit Issues and Pull Requests!

Both versions need maintenance. If you:

• Are familiar with Python → You can improve the Python version.
• Are familiar with Node.js/TypeScript → You can improve the Node.js version.

📄 License

MIT License - This project is for learning and research purposes only.

👨‍💻 Author

• Original Author: Yunkun Huang - Python version
• Node.js Version: shinjiyu - TypeScript rewrite + Intelligent Cookie management

🔗 Related Links

• Model Context Protocol
• DingTalk Documents
• MCP SDK (Python)
• MCP SDK (Node.js)

Quick Start: Choose your preferred version → View the corresponding README → Install and configure → Start using! 🚀