https://github.com/vinkius-labs/url-parser-mcp
Vinkius Edge high-performance Model Context Protocol (MCP) server for URL parsing and query manipulation.
https://github.com/vinkius-labs/url-parser-mcp
ai-agent developer-tools llm-tool mcp mcp-server modelcontextprotocol parser uri url url-parsing utility vinkius vinkius-edge
Last synced: about 10 hours ago
JSON representation
Vinkius Edge high-performance Model Context Protocol (MCP) server for URL parsing and query manipulation.
- Host: GitHub
- URL: https://github.com/vinkius-labs/url-parser-mcp
- Owner: vinkius-labs
- Created: 2026-06-20T06:10:29.000Z (4 days ago)
- Default Branch: master
- Last Pushed: 2026-06-20T07:04:57.000Z (4 days ago)
- Last Synced: 2026-06-20T09:07:05.105Z (4 days ago)
- Topics: ai-agent, developer-tools, llm-tool, mcp, mcp-server, modelcontextprotocol, parser, uri, url, url-parsing, utility, vinkius, vinkius-edge
- Language: TypeScript
- Homepage: https://vinkius.com/mcp/deterministic-url-engine
- Size: 13 MB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# URL Parser MCP Server
A structural Model Context Protocol (MCP) server that enables autonomous agents to precisely deconstruct, analyze, and manipulate complex Uniform Resource Locators (URLs) and query parameters without the risk of hallucination.
[](https://vinkius.com/mcp/deterministic-url-engine)
[](https://hub.docker.com/r/vinkius/url-parser-mcp)
## Why AI Struggles with URL Parsing
URLs are strict hierarchical structures, but LLMs process them as flat sequences of text tokens. When an agent attempts to extract deeply nested query parameters, resolve relative paths against a base domain, or properly URL-encode specific segments, it frequently corrupts the structure—breaking links or creating malformed API requests.
### The Solution: Structural Deconstruction
The **URL Parser MCP** provides agents with a deterministic URI parsing engine. It breaks down any URL into its exact semantic components (protocol, hostname, port, pathname, search params, and hash) and returns a structured JSON object. This allows the AI to programmatically manipulate query strings and paths with zero risk of syntax errors.
---
## Agentic Tools
* `parse_url`
* **Function**: Deconstructs a raw URL string into a structured, easily manipulated JSON object.
* **Output**: Exact separation of `searchParams`, `hostname`, `protocol`, etc.
* **Use Case**: Web scraping agents analyzing pagination links, or security agents auditing destination domains.
* `build_url`
* **Function**: Safely constructs a complete URL from component parts, ensuring mathematically perfect URL encoding.
## Run on Vinkius Edge (Free Edge Hosting)
Vinkius provides **free, highly available edge hosting** using secure V8 isolates. Deploying to the Vinkius Edge is the fastest way to make this MCP server accessible to any AI agent anywhere, with sub-millisecond response times and zero maintenance.
1. Clone this repository
2. Run the deployment command:
```bash
npx mcpfusion deploy
```
That's it. Your MCP server is now live, secure, and ready to be connected to your agents.
👉 **[Access the URL Parser MCP on Vinkius](https://vinkius.com/mcp/deterministic-url-engine)**
## Local Development
Constructed using [MCP Fusion](https://www.npmjs.com/package/@mcpfusion/core) for reliable, strictly typed execution.
```bash
npm install
npm run dev
```