钉钉文档解析

🚀 钉钉文档解析 MCP サーバー

🎯 これは、钉钉ドキュメントの内容を解析し、HTML を生成するための MCP (Model Context Protocol) サーバーです。

✨ 主な機能

• 🔐 完全な解析プロセス: GET → dentryKey の抽出 → POST → HTML の生成
• 📊 多要素サポート: 段落、表、画像、コードブロック、リッチテキスト
• 🎨 美しいレンダリング: グラデーション UI + ダークコードテーマ
• 📋 コードのコピー: コードブロックでのワンクリックコピーが可能
• 🌐 柔軟な入力: 完全な URL または NODE_ID をサポート
• 📁 自動アーカイブ: ドキュメントのタイトルに基づいて自動的にフォルダを作成
• 🍪 スマート Cookie 管理: 無効な Cookie を自動検出し、ログインを誘導（Node.js バージョン）

🚀 2つのバージョン

このプロジェクトは、Python と Node.js の2つのバージョンを提供しています。機能は同じで、あなたの技術スタックに合わせて選択できます。

📁 ディレクトリ構造

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
# ブラウザが自動的に開き、QR コードでログインすると、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 管理：無効な 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
# ブラウザが自動的に開き、QR コードでログインすると、自動的に保存されます ✅

# 方法 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 管理（無効な 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 を参照 → インストールと設定 → 使用！🚀