GenesisTools MCP Web Reader 服务

关键词

网页抓取Markdown 转换JSON-RPCLLM 集成内容提取

使用说明内容（Markdown格式）

项目简介

  • GenesisTools 提供了一个 MCP 服务器实现（MCP Web Reader），通过 MCP 协议暴露工具集合，供大型语言模型（LLM）客户端调用。

主要功能点

  • MCP 服务器实现：处理 MCP 的 ListTools 与 CallTool 请求，提供清晰的工具描述、输入输出模型，并按 JSON-RPC 形式返回结果。
  • 工具暴露：实现了网页相关工具的 MCP 接口，包括 FetchWebRaw、FetchWebMarkdown、FetchJina 等，支持原始 HTML、Markdown 转换等多种输出。
  • 请求处理与结果封装：接收客户端请求、执行对应工具、返回结构化结果（内容、格式、元数据、计费信息等）。
  • 服务器端能力与扩展：具备跨工具的调用桥接能力，方便后续扩展新的 MCP 服务端工具。

安装与运行要点（简要）

  • 运行环境：Node.js / Bun 环境，代码以 Bun/ESM 方式实现，直接通过 Bun 运行即可。
  • 入口与运行：通过执行 mcp-web-reader 服务入口（src/mcp-web-reader/index.ts）来启动 MCP 服务。
  • 依赖/配置：需要 Brave Search 等外部服务的 API Key 时可在环境变量中配置；未开启的能力将自动降级。

服务器配置示例（JSON，供 MCP 客户端配置使用，不是代码） { "mcpServers": { "mcp-web-reader": { "command": "/path/to/GenesisTools/src/mcp-web-reader/index.ts", "args": [], "env": { // 如需 Brave 搜索，请配置 BRAVE_API_KEY，其他可选项保持空 "BRAVE_API_KEY": "" } } } } 说明

  • serverName: mcp-web-reader
  • command: 服务器入口脚本的完整路径（示例中给出路径占位，请替换为实际部署路径）
  • args: 启动参数（如无可留空）
  • env: 可选环境变量配置，用于开启 Brave 搜索等能力

基本使用方法（易懂步骤）

  • 第一步：准备运行环境
    • 安装 Bun 或 Node.js（本实现建议使用 Bun 环境）。
    • 将仓库代码下载到本地或服务器上。
  • 第二步：启动 MCP 服务器
    • 在服务所在目录执行命令，启动 MCP Web Reader 服务（使用 Bun 直接运行入口脚本）。
  • 第三步：在 MCP 客户端配置
    • 将服务器配置（JSON）写入客户端的 MCP 配置中，指定 serverName、command、args，确保客户端能够通过 MCP 协议与服务端建立连接。
  • 第四步：发送 MCP 请求
    • 客户端通过 ListTools 请求获取暴露的工具列表，通过 CallTool 请求调用具体工具，获得返回的数据。
  • 第五步：查看输出
    • 工具调用完成后，服务端返回结构化结果，LLM 客户端可据此继续处理、渲染或转化。

注意事项

  • 部署时请确保入口脚本可在目标环境直接执行（如 Bun 环境下的 TypeScript/JavaScript 文件）。
  • Brave Search 相关能力需要 BRAVE_API_KEY 环境变量才会启用；未配置时相应能力会降级处理。
  • MCP 客户端仅需要配置服务器信息（命令与参数），无需关注服务端内部实现细节。

关键词 网页抓取, Markdown 转换, JSON-RPC, LLM 集成, 内容提取

分类ID 5

服务器信息

访问项目