Markdown Downloader

🚀 Markdown ダウンローダー MCP サーバー

Markdown ダウンローダーは、強力な MCP（モデルコンテキストプロトコル）サーバーです。これを使うと、簡単にウェブページを Markdown ファイルとしてダウンロードできます。r.jina.ai サービスを利用して、ウェブコンテンツを Markdown 形式に変換する簡便な方法を提供します。

🚀 クイックスタート

Markdown ダウンローダーは、ウェブページを Markdown ファイルに簡単に変換できる便利なツールです。このガイドでは、インストール方法や基本的な使い方を説明します。

✨ 主な機能

• 🌐 r.jina.ai を使用してウェブページを Markdown としてダウンロード
• 📁 ダウンロードディレクトリを設定可能
• 📝 日付スタンプ付きのファイル名を自動生成
• 🔍 ダウンロード済みの Markdown ファイルを一覧表示
• 💾 設定を永続化

📦 インストール

前提条件

• Node.js（バージョン 16 以上）
• npm（Node パッケージマネージャー）

Smithery を通じたインストール

Smithery を通じて、Claude Desktop 用に Markdown ダウンローダーを自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @dazeb/markdown-downloader --client claude

手動インストール

1. リポジトリをクローンします。

   git clone https://github.com/your-username/markdown-downloader.git
   cd markdown-downloader
   

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

Cline/Roo - Cline MCP 設定ファイルへの手動追加

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

💻 使用例

基本的な使用法

1. ダウンロードディレクトリの設定

ダウンロードディレクトリを変更するには、以下のコマンドを実行します。

use set_download_directory /path/to/your/local/download/folder

• ディレクトリが存在し、書き込み可能であることを確認します。
• 設定を将来使用するために永続化します。

2. Markdown のダウンロード

ウェブページを Markdown ファイルとしてダウンロードするには、以下のコマンドを実行します。

use tool download_markdown https://example.com/blog-post

• URL には自動的に r.jina.ai のプレフィックスが付加されます。
• ファイル名の形式は {sanitized-url}-{date}.md です。
• 設定されたダウンロードディレクトリに保存されます。

3. ダウンロード済みファイルの一覧表示

すべてのダウンロード済み Markdown ファイルを一覧表示するには、以下のコマンドを実行します。

use list_downloaded_files

4. ダウンロードディレクトリの取得

現在のダウンロードディレクトリを取得するには、以下のコマンドを実行します。

use get_download_directory

📚 ドキュメント

設定

• 設定は ~/.config/markdown-downloader/config.json に保存されます。
• デフォルトのダウンロードディレクトリは ~/.markdown-downloads です。

トラブルシューティング

• アクティブなインターネット接続があることを確認してください。
• URL が有効でアクセス可能であることを確認してください。
• ダウンロードディレクトリの書き込み権限を確認してください。

セキュリティ

• このツールは r.jina.ai サービスを使用して Markdown コンテンツを取得します。
• ローカルファイルは sanitized 名で保存されます。
• 設定可能なダウンロードディレクトリにより、柔軟性が提供されます。

貢献

このプロジェクトへの貢献は大歓迎です。詳細はプロジェクトのリポジトリを参照してください。