AI导哈

网页URL读取器

一个优先支持原生Markdown响应的MCP服务器，适用于需要处理HTML或JavaScript密集型页面的场景，并可选择为下游LLM工具提供摘要功能。

  • by paullesiak
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 paullesiak/amazing_web_url_reader

使用说明

惊人的Web URL阅读器

Markdown首选原生MCP服务器 text/markdown 当网站支持响应时，返回到仅用于HTML或JavaScript繁重页面的Playwright渲染，并（可选）总结下游LLM工具的结果。默认情况下，我们发送 Accept: text/markdown, text/plain;q=0.99, text/html;q=0.9, */*;q=0.8；通过以下方式覆盖 AMAZING_READER_ACCEPT_HEADER 如果你的客户需要其他东西。

快速开始

  1. 安装Playwright Chromium二进制文件一次：
    uvx --from git+https://github.com/paullesiak/amazing_web_url_reader python -m amazing_web_url_reader --install-browser
  2. 将您的MCP感知代理指向同一位置 uvx 命令（见下面的示例）。使用 python -m amazing_web_url_reader 可以从任何工作目录工作，因此像LM Studio这样的主机不必知道仓库的位置。可执行文件会自动与存储库的主分支保持最新状态。要强制uvx每次刷新Git签出，请添加 UVX_ALWAYS_REFRESH=1 到MCP服务器环境（或运行 uvx --upgrade ... 手动提取最新更改）。

配置选项

变量 必填？ 默认 目的
AMAZING_READER_ACCEPT_HEADER 可选 text/markdown, text/plain;q=0.99, text/html;q=0.9, */*;q=0.8 广告不同 Accept 标题指向目标站点。保持 text/markdown 在保留本土降价谈判价值方面。
AMAZING_READER_SUMMARY_TOKENS 可选 未设置（无摘要） 全局回退令牌目标 use_ollama_summarization 为真，但请求遗漏了 summary_target_tokens.
OLLAMA_HOST 可选 http://localhost:11434 摘要后端的默认主机。
OLLAMA_MODEL 可选 gpt-oss:20b 摘要的默认LLM。
MCP_DEBUG 可选 未设置 设置为 1 用于详细日志记录（stdio连接、跟踪等）。

工具参数(read_web_url_amazing)镜像MCP架构： url （必填）加可选 wait_for_selector, wait_time, scroll_to_bottom, truncate, max_length, character_set, use_ollama_summarization, summary_target_tokens, ollama_host，以及 ollama_model. character_set 默认为 safe_unicode，在保留正常Unicode的同时，剥离病理控制和不可见的方向性标记；使用 unicode 用于原始输出或 ascii 仅用于严格的ASCII输出。

当上游服务器响应时 Content-Type: text/markdown，该工具直接返回该正文并报告 render_method: "native_markdown"否则，它将回退到 render_method: "playwright" 在从页面呈现和提取内容之后。成功的回应包括 http_status_code 当获取层可以观察到一个时。

MCP代理示例

OpenAI Codex(configuration.toml)

[[mcp_servers]]
name = "amazing-web-url-reader"
type = "stdio"
command = "uvx"
args = [
  "--from",  # required: tell uvx to pull straight from GitHub
  "git+https://github.com/paullesiak/amazing_web_url_reader",
  "python",
  "-m",
  "amazing_web_url_reader"
]

[mcp_servers.env]
# Optional overrides — delete the ones you don't need.
AMAZING_READER_ACCEPT_HEADER = "text/markdown, text/plain;q=0.99, text/html;q=0.9, */*;q=0.8"
AMAZING_READER_SUMMARY_TOKENS = "1500"
OLLAMA_HOST = "http://localhost:11434"
OLLAMA_MODEL = "gpt-oss:20b"
MCP_DEBUG = "0"

克劳德代码(mcpServers JSON）

{
  "mcpServers": {
    "amazing-web-reader": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/paullesiak/amazing_web_url_reader",
        "python",
        "-m",
        "amazing_web_url_reader"
      ],
      "env": {
        "AMAZING_READER_SUMMARY_TOKENS": "0",
        "AMAZING_READER_ACCEPT_HEADER": "text/markdown, text/plain;q=0.99, text/html;q=0.9, */*;q=0.8",
        "OLLAMA_HOST": "http://localhost:11434",
        "OLLAMA_MODEL": "gpt-oss:20b"
      }
    }
  }
}

这些代码段演示了服务器理解的每个环境变量；你可以自由地把它们剥回你关心的那些。重新运行您的代理会自动通过以下方式从GitHub获取最新代码 uvx.

相关 MCP