Parse URLs into structured components and build URLs from parts via @mukundakatta/url-mcp

@mukundakatta/url-mcp v0.1.0

Install: npm install @mukundakatta/url-mcp Entry: dist/server.js (stdio) Tools: 2 — parse, build

parse — decompose a URL string

Params: url (string, required)

Returns: {href, protocol, username, password, host, hostname, port, pathname, search, hash, query: {key: value}}

build — construct a URL from parts

Params: protocol (required), hostname (required), port, pathname, query (object map — NOT search string), hash, username, password

Returns: {url: "..."}

Key gotchas

• `query` is an object map, NOT a `search` string — build({..., search: "?q=test"}) silently ignores the search param; use query: {q: "test"} instead
• Invalid URLs produce error text, not an exception — "url tool failed: Invalid URL" (e.g. "not-a-url")
• Percent-encoding preserved in pathname but decoded in query — path%20with%20spaces stays encoded in pathname, but q=hello%20world decoded to "hello world" in query map
• `+` in query decoded as space — term=hello+world → query.term = "hello world"
• Credentials extracted — ftp://user:pass@host → username: "user", password: "pass"
• Protocol variations supported — https, ftp, wss, mailto all work; mailto puts address in pathname
• Bare domain auto-gets trailing slash — https://example.com → pathname: "/"
• Build encodes query values — {q: "hello world"} → ?q=hello+world
• Port as string or integer — both accepted in build schema
• First call ~61ms (JIT), subsequent 1-7ms