MCP URL Format Converter Server

Fetches content from URLs and converts it to HTML, JSON, Markdown, or plain text with safe processing and history tracking.

typescript

5

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You run a flexible MCP URL Format Converter that fetches content from any web URL and transforms it into HTML, JSON, Markdown, or plain text. This lets you access, analyze, or display web content in a consistent, application-friendly format, while keeping a focus on safe, structured output.

How to use

Use an MCP client to send a fetch request to the URL Format Converter. You can request different output formats or let the server pick the best format automatically. The tool handles HTML, JSON, Markdown, and plain text conversions, and it can extract text content when requested.

Practical usage patterns include converting a web page to HTML for rendering in a UI, converting an API response to JSON for processing, or turning a complex page into Markdown for notes. You can also fetch and store a history of recent URLs for quick re-use.

How to install

Prerequisites: Node.js 16.x or higher, and npm or yarn.

Clone the project locally and move into the project directory.

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

Install dependencies.

npm install

Build the project.

npm run build

Run the server.

npm start

Configuration and security

The server includes safe defaults and content sanitization to prevent unsafe output. You can extend or adjust configuration through the standard runtime options supported by your MCP client, keeping inputs validated and outputs sanitized.

There is a dedicated integration example for Claude for Desktop that shows how to wire the server as an MCP endpoint in your local environment.

Testing

You can verify the server behavior using the built-in test suite.

npm run test

Troubleshooting

If you encounter connection errors, ensure the URL is accessible and correctly formed. If conversion results seem off, note that some content types may require additional handling. Some sites may block requests from unknown sources; adjust your environment or try a different URL.

For debugging, enable verbose logs by setting a debug flag in your environment before starting the server.

Available tools

fetch

Fetches content from any URL and converts it to a suitable format automatically.

fetch-json

Fetches content from a URL and converts it to JSON format, with optional pretty-printing.

fetch-html

Fetches content from a URL and converts it to HTML, with an option to extract text content.

fetch-markdown

Fetches content from a URL and converts it to Markdown.

fetch-text

Fetches content from a URL and converts it to plain text.

web-search

Provides an interface to Perplexity search capabilities when supported by the MCP host.

deep-research

Provides an interface to deeper research capabilities when supported by the MCP host.

recent-urls

Maintains a log of recently fetched URLs with timestamps and formats.