go_mcp_server_mdurl

by hightemp

301 downloads Not rated yet
GitHub

About

A simple MCP (Model Context Protocol) server that provides tools for converting web content to Markdown format.

Explore

- Converts URL content to Markdown
- Extracts main article content from a URL
- Converts entire HTML of a URL to Markdown
- Supports stdio and SSE transport modes
- Available as a Go binary or npm package
- Compatible with multiple MCP clients

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name go_mcp_server_mdurl
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Go 1.23+

{
  "mcpServers": {
    "mdurl": {
      "command": "/path/to/go_mcp_server_mdurl",
      "args": ["-t", "stdio"]
    }
  }
}

markdown_all_html_of_url

Get markdowned content of all html from URL

markdown_content_of_url

Get markdowned content of article from URL

1. markdown_content_of_url - Extracts the main article content from a URL and converts it to Markdown
2. markdown_all_html_of_url - Converts the entire HTML content from a URL to Markdown

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "go_mcp_server_mdurl": {
            "go_mcp_server_mdurl": {
                "command": "npx",
                "args": [
                    "go-mdurl-mcp-server",
                    "-t",
                    "stdio"
                ]
            }
        }
    }
}

McpServers

{
    "go_mcp_server_mdurl": {
        "command": "npx",
        "args": [
            "go-mdurl-mcp-server",
            "-t",
            "stdio"
        ]
    }
}

A Go MCP (Model Context Protocol) server that converts URL content to Markdown.

Server URL: http://localhost:8890/sse

Requirements

- Go 1.23+

Tools

1. markdown_content_of_url - Extracts the main article content from a URL and converts it to Markdown
2. markdown_all_html_of_url - Converts the entire HTML content from a URL to Markdown

Running

The server can operate in two modes: stdio and sse (Server-Sent Events). By default, it uses sse.

Stdio

go_mcp_server_mdurl -t stdio

SSE

go_mcp_server_mdurl -t sse -h 0.0.0.0 -p 8890

SSE endpoint:

http://localhost:8890/sse

Build

make build

Binary output: ./go_mcp_server_mdurl

npm / npx

This repo includes an npm wrapper so the server can be installed and run via npx.

Build npm package (multi-platform binaries)

npm run build:npm

This creates platform binaries under native/ and prepares the package for npm pack/publish.

Run with npx

After publishing the package (or using a local tarball), you can run:

npx go-mdurl-mcp-server -t stdio

To run a specific version:

npx [email protected] -t stdio

For a local tarball:

npm pack
npx ./go-mdurl-mcp-server-*.tgz -t stdio

Claude Code

claude mcp add --transport stdio mdurl -- npx -y go-mdurl-mcp-server -t stdio

In project .mcp.json or global ~/.claude.json:

{
  "mcpServers": {
    "mdurl": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "go-mdurl-mcp-server", "-t", "stdio"]
    }
  }
}

Codex CLI

Codex supports MCP servers in ~/.codex/config.toml or via the codex mcp add command.

Add via CLI:

codex mcp add mdurl -- npx -y go-mdurl-mcp-server -t stdio

Or configure in ~/.codex/config.toml:

[mcp_servers.mdurl]
command = "npx"
args = ["-y", "go-mdurl-mcp-server", "-t", "stdio"]

Cursor

- macOS/Linux: ~/.cursor/mcp.json
- Windows: %USERPROFILE%\\.cursor\\mcp.json

{
  "mcpServers": {
    "mdurl": {
      "command": "npx",
      "args": ["-y", "go-mdurl-mcp-server", "-t", "stdio"]
    }
  }
}

MCP Client Config Example

{
  "mcpServers": {
    "mdurl": {
      "command": "/path/to/go_mcp_server_mdurl",
      "args": ["-t", "stdio"]
    }
  }
}

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.