使用说明

项目简介

Fetch-MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型 (LLM) 客户端提供便捷的网络内容获取能力。它集成了两个核心工具，可以从指定的 URL 地址抓取网页内容，并提取 YouTube 视频的文字转录，从而扩展 LLM 的上下文信息来源，提升应用的功能性和实用性。

主要功能点

网页内容抓取 (fetch_url): 能够根据 URL 获取网页的 HTML 或文本内容，并支持转换为 Markdown 格式。可以设置内容的最大长度和起始位置，方便用户获取网页的关键信息。对于图片类型的 URL，可以返回 Base64 编码的图像数据。
YouTube 视频转录抓取 (fetch_youtube_transcript): 可以提取指定 YouTube 视频的完整文字转录，包括时间戳信息，方便 LLM 理解视频内容。

安装步骤

访问最新发布页面下载预编译好的程序包。
解压程序包到本地目录。
确保你的运行环境已安装 Node.js 和 npm (或 yarn)。如果未安装，请先安装 Node.js 运行环境。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接 Fetch-MCP 服务器。

{
  "serverName": "fetch-mcp",
  "command": "node",
  "args": [
    "cli.js"
  ],
  "transport": "stdio"
}

参数说明:

'serverName': 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。
'command': 启动服务器的命令，这里使用 'node' 命令来执行 JavaScript 文件。
'args': 传递给 'command' 的参数，'cli.js' 是服务器的入口文件。
'transport': 传输协议，默认为 'stdio' (标准输入输出)。如果需要使用 SSE 协议，可以将 'args' 修改为 '["cli.js", "--sse"]'，并将 'transport' 设置为 'sse' (SSE 协议需要额外的 HTTP 服务器配置，具体请参考仓库文档)。

基本使用方法

配置完成后，MCP 客户端可以通过 JSON-RPC 协议调用 Fetch-MCP 服务器提供的工具。

示例 - 调用 'fetch_url' 工具:

{
  "jsonrpc": "2.0",
  "method": "call",
  "params": {
    "tool_name": "fetch_url",
    "arguments": {
      "url": "https://www.example.com",
      "max_length": 1000
    }
  },
  "id": "fetch-url-1"
}

示例 - 调用 'fetch_youtube_transcript' 工具:

{
  "jsonrpc": "2.0",
  "method": "call",
  "params": {
    "tool_name": "fetch_youtube_transcript",
    "arguments": {
      "url": "https://www.youtube.com/watch?v=xxxxxxxxxxx"  // 替换为实际的 YouTube 视频 URL
    }
  },
  "id": "fetch-youtube-transcript-1"
}

请参考 Model Context Protocol (MCP) 官方文档了解更多关于 MCP 协议和客户端使用的信息。

关键词