Markdown Downloader MCP Server 使用说明

项目简介

Markdown Downloader MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它允许用户通过调用工具将网页下载为 Markdown 格式的文件。该服务器利用 r.jina.ai 服务进行网页到 Markdown 的转换，并将文件保存在用户本地配置的目录下。

主要功能点

网页转 Markdown 下载: 使用 'r.jina.ai' 服务将指定 URL 的网页内容转换为 Markdown 格式并下载。
可配置下载目录: 允许用户自定义 Markdown 文件的本地保存目录。
自动生成文件名: 下载的文件名自动根据 URL 和日期生成，方便管理。
列出已下载文件: 可以列出指定目录下已下载的 Markdown 文件列表。
持久化配置: 下载目录等配置信息会被持久化保存，下次启动服务器时自动加载。

安装步骤

克隆仓库:

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

安装依赖:
```
npm install
```
构建项目:
```
npm run build
```

服务器配置

要将 Markdown Downloader MCP Server 添加到 MCP 客户端（如 Cline/Roo-Cline），您需要配置服务器的启动命令。以下是一个示例配置，请根据您的实际安装路径进行调整：

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/path/to/markdown-downloader/build/index.js"  // 请替换为 markdown-downloader 项目 build 目录下的 index.js 文件的实际路径
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory",
        "list_downloaded_files",
        "get_download_directory",
        "create_subdirectory"
      ]
    }
  }
}

配置参数说明:

'command': 启动服务器的命令，这里使用 'node' 解释器。
'args': 传递给 'node' 命令的参数，指向编译后的 'index.js' 文件路径。请务必将 '/path/to/markdown-downloader/build/index.js' 替换为您本地 markdown-downloader 项目 'build' 目录中 'index.js' 文件的绝对路径。 您需要根据实际情况修改此路径，确保 MCP 客户端能够找到并执行服务器程序。
'disabled': 设置为 'false' 表示启用该服务器。
'alwaysAllow': 列出允许客户端无需用户确认即可调用的工具名称。

注意: 请根据您的操作系统和文件系统，将 '/path/to/markdown-downloader/build/index.js' 替换为正确的绝对路径。您可以在终端中进入 'markdown-downloader' 目录，执行 'pwd' 命令获取当前目录的路径，然后拼接上 'build/index.js'。

基本使用方法

以下是一些基本的使用示例，您可以通过 MCP 客户端（如 Cline/Roo-Cline）来调用这些工具：

设置下载目录:

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

将 '/path/to/your/local/download/folder' 替换为您希望保存 Markdown 文件的本地目录的绝对路径。

下载网页为 Markdown:

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

将 'https://example.com/blog-post' 替换为您要下载的网页 URL。

列出已下载文件:
```
use list_downloaded_files
```
列出当前配置下载目录下的所有 Markdown 文件。

获取当前下载目录:

use get_download_directory

获取当前配置的 Markdown 文件下载目录。

创建子目录:

use create_subdirectory my-new-subdirectory

在当前下载目录下创建一个名为 'my-new-subdirectory' 的子目录。

更多详细信息和高级用法，请参考仓库的 README 文件和源代码。

关键词