go_mcp_server_mdurl
About
A simple MCP (Model Context Protocol) server that provides tools for converting web content to Markdown format.
Details
- Author
- hightemp
- Downloads
- 301
- Categories
- Other
Jump to
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
go_mcp_server_mdurlCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the binary with -t stdio for stdio mode or -t sse -h 0.0.0.0 -p 8890 for SSE mode (default is SSE). Alternatively, use the npm wrapper via npx go-mdurl-mcp-server. Configuration examples are provided for Claude Code, Codex CLI, and Cursor.
markdown_all_html_of_url
Get markdowned content of all html from URL
markdown_content_of_url
Get markdowned content of article from URL
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"
]
}
}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 go-mdurl-mcp-server@1.0.0 -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"]
}
}
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
