使用说明

项目简介

fetch-mcp 是一个实现了 Model Context Protocol (MCP) 标准的服务器应用。它旨在为大型语言模型 (LLM) 客户端提供访问外部网络资源的能力，具体功能是通过注册和执行工具来完成。当前版本提供了抓取任意网页内容和获取 YouTube 视频字幕这两个核心工具。

主要功能点

网页内容抓取: 允许 LLM 通过指定 URL 获取网页、纯文本或图片内容。支持将 HTML 内容自动转换为 Markdown 格式，并提供控制返回内容长度和起始位置的选项。
YouTube 字幕获取: 通过 YouTube 视频 URL 获取该视频的完整字幕文本，并提供精确的时间戳信息，便于对视频内容进行深入分析。
MCP 标准接口: 遵循 MCP 协议规范，通过 JSON-RPC 格式进行通信，使任何支持 MCP 的客户端都能与之集成。
多种传输方式: 支持通过标准输入输出 (Stdio) 或 Server-Sent Events (SSE) 两种方式与客户端建立连接和交换数据。

安装步骤

fetch-mcp 服务器是一个 Node.js 应用程序。要运行它，您需要在您的系统上安装 Node.js 环境。然后，您可以从项目的最新发布页面下载预编译的文件，或克隆仓库并自行构建。

一般来说，安装步骤如下：

确保已安装 Node.js (建议使用 LTS 版本)。
下载或克隆 fetch-mcp 仓库代码。
进入项目目录，运行 'npm install' 安装依赖项。
运行构建命令（如果项目需要编译，例如 'npm run build'）。

具体的安装和启动细节请参考项目仓库中的说明。

服务器配置

MCP 客户端需要知道如何启动并连接到 fetch-mcp 服务器。通常，这涉及到配置服务器的可执行文件路径、启动参数以及使用的传输协议。根据您的安装方式和启动需求，您需要向您的 MCP 客户端提供以下信息：

服务器名称: 'fetch-mcp' (用于客户端识别)
启动命令 (command): 启动 fetch-mcp 服务器进程的命令。例如，如果是 Node.js 脚本，可能是 'node' 或指向打包后可执行文件的路径。
启动参数 (args): 传递给启动命令的参数列表。通常需要包含主脚本文件的路径 (例如 '/path/to/your/fetch-mcp/cli.js')。如果需要使用 SSE 传输，可能还需要一个特定参数 (例如 '--sse')。
传输协议 (type): 指定客户端应使用哪种方式与服务器通信，支持 'stdio' (标准输入输出) 和 'sse' (Server-Sent Events)。
连接信息 (url/port, 仅 SSE): 如果使用 SSE 协议，还需要提供服务器监听的 URL 和端口号，例如 'http://localhost:3000'。

具体的配置格式和位置取决于您使用的 MCP 客户端软件。请参考您客户端的文档来设置这些信息。

基本使用方法

fetch-mcp 服务器启动并与 MCP 客户端建立连接后，客户端即可发现服务器提供的工具 ('fetch_url' 和 'fetch_youtube_transcript')。LLM 客户端可以根据用户的指令或需求，构造相应的 MCP JSON-RPC 请求来调用这些工具。例如，当用户要求总结某个网页内容时，LLM 可以调用 'fetch_url' 工具获取网页文本；当用户询问 YouTube 视频内容时，可以调用 'fetch_youtube_transcript' 获取字幕。工具执行完成后，结果会通过 MCP 协议返回给客户端，供 LLM 使用。具体如何触发和使用这些工具，完全取决于 MCP 客户端的设计和集成方式。

关键词