MCP URL 格式转换器

一个模型上下文协议 (MCP) 服务器，可以从任何 URL 获取内容并将其转换为您所需的输出格式。

概述

MCP URL 格式转换器提供工具，用于从任何 Web URL 检索内容，并将其转换为各种格式（HTML、JSON、Markdown 或纯文本），无论原始内容类型如何。它旨在与任何 MCP 兼容的客户端（包括 Claude for Desktop）一起使用，使 LLM 能够以一致的格式访问、转换和分析 Web 内容。

特性

• 🔄 格式转换: 将任何 Web 内容转换为 HTML、JSON、Markdown 或纯文本
• 🌐 通用输入支持: 处理网站、API、原始文件等
• 🔍 自动内容检测: 智能识别源格式
• 🧰 强大的库支持: 使用行业标准库：
  • Cheerio 用于 HTML 解析
  • Marked 用于 Markdown 处理
  • Fast-XML-Parser 用于 XML 处理
  • CSVtoJSON 用于 CSV 转换
  • SanitizeHTML 用于安全
  • Turndown 用于 HTML 到 Markdown 的转换
• 🔧 高级格式处理:
  • 带有元数据提取的 HTML 解析
  • JSON 漂亮打印和结构保留
  • 带有样式的 Markdown 渲染
  • CSV 到表格的转换
  • XML 到 JSON 的转换
• 📜 历史记录跟踪: 维护最近获取的 URL 的日志
• 🛡️ 安全重点: 内容清理以防止 XSS 攻击

安装

前提条件

• Node.js 16.x 或更高版本
• npm 或 yarn

快速开始

1. 克隆存储库：

   git clone https://github.com/yourusername/mcp-url-converter.git
   cd mcp-url-converter
   

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

4. 运行服务器：

   npm start
   

与 Claude for Desktop 集成

1. 打开您的 Claude for Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 将 URL 转换器服务器添加到您的配置：

   {
     "mcpServers": {
       "url-converter": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-url-converter/build/index.js"]
       }
     }
   }
   

3. 重启 Claude for Desktop

可用工具

fetch

从任何 URL 获取内容并自动检测最佳输出格式。

参数：

• url (字符串，必需): 要从中获取内容的 URL
• format (字符串，可选): 要转换成的格式 (auto, html, json, markdown, text)。默认值：auto

示例：

你能获取 https://example.com 并选择最佳格式来显示它吗？

fetch-json

从任何 URL 获取内容并将其转换为 JSON 格式。

参数：

• url (字符串，必需): 要从中获取内容的 URL
• prettyPrint (布尔值，可选): 是否漂亮打印 JSON。默认值：true

示例：

你能获取 https://example.com 并将其转换为 JSON 格式吗？

fetch-html

从任何 URL 获取内容并将其转换为 HTML 格式。

参数：

• url (字符串，必需): 要从中获取内容的 URL
• extractText (布尔值，可选): 是否仅提取文本内容。默认值：false

示例：

你能获取 https://api.example.com/users 并将其转换为 HTML 吗？

fetch-markdown

从任何 URL 获取内容并将其转换为 Markdown 格式。

参数：

• url (字符串，必需): 要从中获取内容的 URL

示例：

你能获取 https://example.com 并将其转换为 Markdown 吗？

fetch-text

从任何 URL 获取内容并将其转换为纯文本格式。

参数：

• url (字符串，必需): 要从中获取内容的 URL

示例：

你能获取 https://example.com 并将其转换为纯文本吗？

web-search 和 deep-research

这些工具提供对 Perplexity 搜索功能的接口（当 MCP 主机支持时）。

可用资源

recent-urls://list

返回最近获取的 URL 列表，其中包含时间戳和输出格式。

示例：

我最近获取了哪些 URL？

安全

此服务器实施了多项安全措施：

• 使用 sanitize-html 进行 HTML 清理，以防止 XSS 攻击
• 处理前的内容验证
• 错误处理和安全默认值
• 使用 Zod 进行输入参数验证
• 安全的输出编码

测试

您可以使用 MCP Inspector 测试服务器：

npm run test

故障排除

常见问题

1. 连接错误: 验证 URL 是否可访问且格式正确
2. 转换错误: 某些复杂内容可能无法在格式之间干净地转换
3. 跨域问题: 某些网站可能会阻止来自未知来源的请求

调试模式

要获取其他调试信息，请设置 DEBUG 环境变量：

DEBUG=mcp:* npm start

许可证

此项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 使用 模型上下文协议 构建
• 使用具有安全重点的现代、积极维护的库
• 基于 OWASP 建议的清理方法

---

上次更新：2025 年 3 月 29 日