使用说明
项目简介
'mcp-server-fetch-typescript' 是一个基于 Model Context Protocol (MCP) 的服务器,专注于提供网页内容抓取和转换功能。它通过工具化的方式,让大型语言模型(LLM)能够便捷地获取和处理来自网页的各种信息,从而增强 LLM 在处理网络内容方面的能力。
主要功能点
- 获取原始文本 (get_raw_text): 直接从 URL 获取网页的原始文本内容,适用于 JSON、XML、CSV 等结构化数据或纯文本文件。
- 获取渲染后HTML (get_rendered_html): 使用无头浏览器(Playwright)获取完整渲染后的 HTML 内容,包括 JavaScript 动态生成的内容,适用于现代 Web 应用和单页应用 (SPA)。
- 转换为Markdown (get_markdown): 将网页内容转换为结构清晰的 Markdown 格式,保留表格、定义列表等元素,适合内容归档和文档处理。
- 提取Markdown摘要 (get_markdown_summary): 自动提取网页主要内容并转换为 Markdown 格式,去除导航、页眉、页脚等干扰元素,专注于文章和博客的核心内容。
安装步骤
你可以选择全局安装或作为项目依赖安装:
全局安装:
npm install -g mcp-server-fetch-typescript
作为项目依赖安装:
npm install mcp-server-fetch-typescript
安装前请确保已安装 Node.js 和 npm。
服务器配置
要将 'mcp-server-fetch-typescript' 配置为 MCP 服务器,你需要在 MCP 客户端(例如 Claude Desktop)的配置文件中添加服务器信息。
对于 Claude Desktop (配置示例):
打开 Claude Desktop 的配置文件 ('claude_desktop_config.json'),通常位于:
- MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
在 'mcpServers' 字段中添加如下配置:
"mcpServers": { "mcp-server-fetch-typescript": { "command": "npx", "args": [ "-y", "mcp-server-fetch-typescript" ] } }
或者,如果你选择从本地构建运行,可以使用以下配置 (假设项目路径为 '/path/to/mcp-server-fetch-typescript'):
"mcpServers": { "mcp-server-fetch-typescript": { "command": "node", "args": [ "/path/to/mcp-server-fetch-typescript/build/index.js" ] } }
'command': 启动服务器的命令,这里 'npx' 会查找并执行全局或项目本地安装的 'mcp-server-fetch-typescript' 包, 'node' 命令直接执行构建后的服务器代码。
'args': 传递给启动命令的参数, '-y' 参数用于 'npx' 自动确认安装, '/path/to/mcp-server-fetch-typescript/build/index.js' 是服务器构建后的入口文件路径。你需要根据实际安装方式和项目路径调整 'command' 和 'args'。
基本使用方法
配置完成后,MCP 客户端(如 Claude Desktop)将能够发现并使用 'mcp-server-fetch-typescript' 提供的工具。你可以通过客户端界面或指令,调用 'get_raw_text', 'get_rendered_html', 'get_markdown', 或 'get_markdown_summary' 等工具,并提供目标网页的 URL 作为参数,即可获取相应的网页内容。
信息
分类
网页与API