Fetch MCP Server

Что умеет сервер

Сервер поддерживает один инструмент fetch и одноимённый промпт. Инструмент принимает адрес url, скачивает страницу и возвращает её содержимое в виде Markdown. Параметр max_length ограничивает объём ответа (по умолчанию 5000 символов), start_index позволяет начать с нужного места, так что длинную страницу модель читает по частям, пока не найдёт нужное. Параметр raw отдаёт исходное содержимое без преобразования. Инструмент помечен как только читающий: он ничего не меняет, но обращается к произвольным адресам в интернете.

Если на компьютере установлен Node.js, сервер использует более надёжный упроститель HTML. Ошибки загрузки (запрет в robots.txt, недоступная страница, код ошибки HTTP, закрытый адрес) возвращаются как результат инструмента с флагом isError, поэтому модель видит причину и может выбрать другой путь.

Когда использовать

Сервер нужен, когда известен адрес и надо прочитать его: документацию библиотеки, статью, README, страницу с условиями. Он не ищет сам, поэтому адрес даёт пользователь или другой инструмент, например поисковый сервер. Для динамических страниц, которые собираются скриптами после загрузки, лучше подойдёт управление браузером.

Ограничения и безопасность

Разработчики предупреждают, что сервер ходит по сети и может представлять риск. По умолчанию он отказывается загружать закрытые, петлевые, локальные и другие непубличные адреса, включая служебный адрес метаданных облака 169.254.169.254, и так же проверяет каждый переход по перенаправлению. Защиту отключает аргумент --allow-private-ips, но включать его стоит только когда действительно нужно читать локальные или внутренние страницы. В README оговорено, что проверка не защищает от подмены DNS между проверкой и соединением и не работает для имён, которые может разрешить только прокси.

Если запрос пришёл от модели, сервер соблюдает robots.txt сайта; отключить это можно аргументом --ignore-robots-txt. Можно задать свой --user-agent и прокси через --proxy-url. Сервер написан на Python и требует MCP Python SDK версии 2.x.

Установка

Рекомендуется uv: отдельная установка не нужна, сервер запускается командой uvx mcp-server-fetch. Вариант через pip:

pip install mcp-server-fetch

После установки сервер запускается так:

python -m mcp_server_fetch

Claude Desktop

README называет приложение Claude.app и предлагает добавить в настройки Claude такой блок (вариант с uvx):

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

Вариант с Docker:

{
  "mcpServers": {
    "fetch": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/fetch"]
    }
  }
}

Вариант с установкой через pip:

{
  "mcpServers": {
    "fetch": {
      "command": "python",
      "args": ["-m", "mcp_server_fetch"]
    }
  }
}

VS Code

Добавьте в пользовательские настройки (JSON) через Ctrl + Shift + P и Preferences: Open User Settings (JSON):

{
  "mcp": {
    "servers": {
      "fetch": {
        "command": "uvx",
        "args": ["mcp-server-fetch"]
      }
    }
  }
}

Блок можно положить и в файл .vscode/mcp.json в проекте. Для него README отмечает, что ключ mcp нужен именно при использовании этого файла.

Windows

Если сервер зависает по тайм-ауту, задайте кодировку:

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}