Fetch MCP
by zcaceres (community) Claude Desktop, Claude Code, OpenCode, любой MCP-клиент, Node.js, npm
MCP-сервер для HTTP-запросов и скрейпинга веб-страниц. Загружает URL, извлекает контент страниц, конвертирует HTML в Markdown для удобного потребления LLM.
MCP-сервер для чтения веб-страниц как чистый Markdown через Jina Reader API. Идеально для парсинга документации, статей …
MCP-сервер для управления Blender через LLM. Создавай и редактируй 3D-объекты, материалы и сцены на естественном языке …
AI-агент для навигации и редактирования кода через MCP с семантическим анализом. Использует language server protocol для …
Python-фреймворк для быстрого создания MCP-серверов. Декораторы @mcp.tool, @mcp.resource, @mcp.prompt — минимальный бойлерплейт. Поддерживает HTTP/SSE и stdio …
# Claude Desktop — claude_desktop_config.json:
{ "mcpServers": { "fetch": { "command": "uvx", "args": ["mcp-server-fetch"] } } }
# Claude Code (CLI):
claude mcp add fetch -- uvx mcp-server-fetch
# OpenCode — ~/.config/opencode/opencode.json:
{ "mcp": { "fetch": { "type": "local", "command": ["uvx", "mcp-server-fetch"] } } }
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.