mcpField
G
go_mcp_server_mdurl

go_mcp_server_mdurl

Local
github.com/hightempBrowser Automation0Updated 42w ago
Repository

About go_mcp_server_mdurl

go_mcp_server_mdurl is a Go MCP server that extracts web content from URLs and converts it to Markdown. It offers separate tools for main article content and the full HTML page, and runs over stdio or SSE.

Key features

  1. 01Extract article content as Markdown
  2. 02Convert full HTML to Markdown
  3. 03stdio and SSE transport modes
  4. 04Go implementation
  5. 05npm and npx wrapper

Use cases

  1. 01Turning a web article into Markdown
  2. 02Converting an entire page for Markdown processing

MCP support

It exposes two URL-to-Markdown tools to MCP clients: one for main article content and one for the full HTML page. It supports stdio and SSE transports.

#markdown#golang#mcp#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "go_mcp_server_mdurl": {
      "command": "npx",
      "args": [
        "-y",
        "go-mdurl-mcp-server"
      ]
    }
  }
}
Run commandnpx -y go-mdurl-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmgo-mdurl-mcp-server

Tools

2

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
urlstringYesurl of site

Details

From the project README

go_mcp_server_mdurl

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"]
    }
  }
}

README image

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.