内容
# URL 解析 MCP 服务器
一个结构化的模型上下文协议（MCP）服务器，能够使自主代理精确地分解、分析和操作复杂的统一资源定位符（URLs）和查询参数，而无需担心出现错误的解析。
[](https://vinkius.com/mcp/deterministic-url-engine)
[](https://hub.docker.com/r/vinkius/url-parser-mcp)
## 为什么 AI 在 URL 解析方面存在困难
URL 是严格的层次结构，但大型语言模型（LLMs）将其处理为平坦的文本令牌序列。当代理尝试提取深度嵌套的查询参数、针对基域解析相对路径或正确地对特定段进行 URL 编码时，它经常会破坏结构——破坏链接或创建畸形的 API 请求。
### 解决方案：结构化分解
**URL 解析 MCP** 为代理提供了一个确定性的 URI 解析引擎。它将任何 URL 分解为其确切的语义组件（协议、主机名、端口、路径、搜索参数和哈希），并返回一个结构化的 JSON 对象。这允许 AI 以零风险的方式编程方式操作查询字符串和路径，不会出现语法错误。
---
## 代理工具
* `parse_url`
* **功能**：将原始 URL 字符串分解为结构化、易于操作的 JSON 对象。
* **输出**：精确分离 `searchParams`、`hostname`、`protocol` 等。
* **用例**：网页抓取代理分析分页链接，或安全代理审计目标域。
* `build_url`
* **功能**：安全地从组件部分构造完整的 URL，确保数学上完美的 URL 编码。
## 在 Vinkius Edge 上运行（免费边缘托管）
Vinkius 提供 **免费、高可用性的边缘托管**，使用安全的 V8 隔离。部署到 Vinkius Edge 是使此 MCP 服务器可供任何 AI 代理访问的最快方式，具有毫秒级响应时间和零维护。
1. 克隆此仓库
2. 运行部署命令：
```bash
npx mcpfusion deploy
```
就这样。您的 MCP 服务器现在已经上线、安全，并已准备好与您的代理连接。
👉 **[在 Vinkius 上访问 URL 解析 MCP](https://vinkius.com/mcp/deterministic-url-engine)**
## 本地开发
使用 [MCP Fusion](https://www.npmjs.com/package/@mcpfusion/core) 构建，可靠、严格地执行。
```bash
npm install
npm run dev
```
