使用说明

项目简介

'tatn_mcp-server-fetch-typescript' 是一个基于 Model Context Protocol (MCP) 构建的服务器，专注于为大型语言模型 (LLM) 应用提供网页内容抓取和转换能力。它通过标准化的 MCP 协议与客户端通信，提供多种工具，可以从 URL 获取不同格式的网页内容，并将其转换为适合 LLM 理解和处理的文本格式。

主要功能点

多种内容获取工具: 提供 'get_raw_text'、'get_rendered_html'、'get_markdown' 和 'get_markdown_summary' 四个工具，满足不同的网页内容获取需求。
- 'get_raw_text': 直接获取网页的原始文本内容，适用于 JSON、XML、CSV 等结构化数据或纯文本文件。速度快，不进行浏览器渲染。
- 'get_rendered_html': 使用无头浏览器 (Playwright) 完整渲染网页，包括执行 JavaScript 生成的内容。适用于现代 Web 应用和单页应用 (SPA)。
- 'get_markdown': 将网页内容转换为 Markdown 格式，保留标题、列表、表格等结构，适合内容存档和文档处理。
- 'get_markdown_summary': 提取网页主要内容并转换为 Markdown 格式，自动去除导航、页眉页脚等无关信息，适用于文章和博客内容提取。
易于集成: 遵循 MCP 协议，可以与任何支持 MCP 协议的 LLM 客户端（如 Claude Desktop）轻松集成。

安装步骤

作为全局包安装 (推荐):

打开终端并执行以下命令：

npm install -g mcp-server-fetch-typescript

作为项目依赖安装:

在你的项目目录下打开终端并执行以下命令：

npm install mcp-server-fetch-typescript

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），你需要提供服务器的启动命令和参数。以下是配置示例 (JSON 格式)，请根据你的安装方式选择相应的配置添加到 MCP 客户端的配置文件中。

如果使用全局包安装，配置如下:

"mcpServers": {
  "mcp-server-fetch-typescript": {
    "command": "npx",  // 使用 npx 命令来运行全局安装的包
    "args": [
      "-y",           // (可选) 自动确认 npx 的安装提示
      "mcp-server-fetch-typescript" //  要运行的 MCP 服务器包名
    ]
  }
}

如果克隆仓库并本地构建，配置如下 (需要替换 '/path/to/mcp-server-fetch-typescript' 为你的实际仓库路径):

"mcpServers": {
  "mcp-server-fetch-typescript": {
    "command": "node", // 使用 node 命令来运行 JavaScript 文件
    "args": [
      "/path/to/mcp-server-fetch-typescript/build/index.js" //  指向构建后的服务器入口文件
    ]
  }
}

Claude Desktop 配置文件路径:

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

基本使用方法

配置完成后，MCP 客户端（如 Claude Desktop）将能够检测到并使用 'mcp-server-fetch-typescript' 服务器提供的工具。

当 LLM 需要获取网页内容时，它可以通过 MCP 协议调用服务器提供的工具，例如：

使用 'get_raw_text' 工具获取指定 URL 的原始文本。
使用 'get_rendered_html' 工具获取渲染后的完整 HTML 内容。
使用 'get_markdown' 或 'get_markdown_summary' 工具将网页内容转换为 Markdown 格式。

具体的工具调用方式和参数设置取决于 MCP 客户端的功能和界面。请参考你使用的 MCP 客户端的文档来了解如何使用配置的 MCP 服务器及其提供的工具。

关键词