переведено ИИ

Fetch MCP Server

MCP-сервер для загрузки веб-контента в различных форматах — HTML, JSON, обычный текст, Markdown, читаемое содержимое статей и расшифровки YouTube-видео.

Инструменты

Все инструменты принимают следующие общие параметры:

Параметр	Тип	Обязательный	Описание
`url`	строка	Да	URL для загрузки
`headers`	объект	Нет	Пользовательские заголовки для включения в запрос
`max_length`	число	Нет	Максимальное количество возвращаемых символов (по умолчанию: 5000)
`start_index`	число	Нет	Начать с этого индекса символа (по умолчанию: 0)
`proxy`	строка	Нет	URL прокси (например, `http://proxy:8080`)

fetch_html — Загружает веб-сайт и возвращает его исходное HTML-содержимое.
fetch_markdown — Загружает веб-сайт и возвращает его содержимое, преобразованное в Markdown.
fetch_txt — Загружает веб-сайт и возвращает обычный текст с удалёнными HTML-тегами, скриптами и стилями.
fetch_json — Загружает URL и возвращает JSON-ответ.
fetch_readable — Загружает веб-сайт и извлекает основное содержимое статьи с помощью Mozilla Readability, возвращая его в формате Markdown. Удаляет навигацию, рекламу и шаблонные элементы. Идеально подходит для статей и блог-постов.
fetch_youtube_transcript — Загружает субтитры/расшифровку YouTube-видео. Использует yt-dlp, если он доступен, в противном случае извлекает данные напрямую со страницы. Принимает дополнительный параметр lang (по умолчанию: "en") для выбора языка субтитров.

Установка

В качестве MCP-сервера

Добавьте в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["mcp-fetch-server"]
    }
  }
}

В качестве CLI

npx mcp-fetch <command> <url> [flags]

Или установите глобально:

npm install -g mcp-fetch-server
mcp-fetch <command> <url> [flags]

Использование CLI

mcp-fetch <command> <url> [flags]

Команды

Команда	Описание
`html`	Загрузить URL и вернуть исходный HTML
`markdown`	Загрузить URL и вернуть Markdown
`readable`	Загрузить URL и вернуть содержимое статьи в формате Markdown (через Readability)
`txt`	Загрузить URL и вернуть обычный текст
`json`	Загрузить URL и вернуть JSON
`youtube`	Загрузить расшифровку YouTube-видео

Флаги

Флаг	Описание
`--max-length <N>`	Максимальное количество возвращаемых символов
`--start-index <N>`	Начать с этого индекса символа
`--proxy <URL>`	URL прокси
`--lang <code>`	Код языка для расшифровок YouTube (по умолчанию: `en`)
`--help`	Показать сообщение справки
`--version`	Показать версию

Примеры

# Загрузить страницу в формате markdown
mcp-fetch markdown https://example.com

# Извлечь содержимое статьи без шаблонных элементов
mcp-fetch readable https://example.com/blog/post

# Получить расшифровку YouTube на испанском языке
mcp-fetch youtube https://www.youtube.com/watch?v=dQw4w9WgXcQ --lang es

# Загрузка с ограничением по длине
mcp-fetch html https://example.com --max-length 10000

# Загрузка через прокси
mcp-fetch json https://api.example.com/data --proxy http://proxy:8080

Переменные окружения

Переменная	Описание
`DEFAULT_LIMIT`	Лимит символов в ответе по умолчанию (по умолчанию: `5000`, установите `0` для отсутствия ограничения)
`MAX_RESPONSE_BYTES`	Максимальный размер тела ответа в байтах (по умолчанию: `10485760` / 10 МБ)

Пример с пользовательским лимитом:

{
  "mcpServers": {
    "fetch": {
      "command": "npx",
      "args": ["mcp-fetch-server"],
      "env": {
        "DEFAULT_LIMIT": "50000"
      }
    }
  }
}

Возможности

Загрузка веб-контента в форматах HTML, JSON, обычного текста или Markdown
Извлечение содержимого статей с помощью Mozilla Readability (удаление рекламы, навигации и шаблонных элементов)
Извлечение расшифровок YouTube-видео (через yt-dlp или прямое извлечение)
Поддержка прокси для запросов за файрволами
Постраничная навигация с помощью max_length и start_index
Пользовательские заголовки запросов
Защита от SSRF (блокировка адресов частной сети/localhost и DNS rebinding)
Ограничение размера ответа для предотвращения исчерпания памяти

Разработка

bun install
bun run dev     # запуск в режиме отслеживания изменений
bun test        # запуск тестов
bun run build   # сборка для producción

Лицензия

Данный проект распространяется под лицензией MIT.

Fetch MCP