fantoma — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для браузерной автоматизации через дерево доступности. Передаёт агенту структурированный текст вместо скриншотов и экономит контекст.
claude mcp add fantoma -- uvx fantomaЧто делает fantoma
Сервер открывает веб-страницы через скрытный браузер Camoufox и транслирует их содержимое агенту в виде чистого Markdown. Вместо обработки тяжёлых скриншотов через vision-модели он опирается на дерево доступности. Каждый шаг обходится примерно в 500 токенов вместо тысяч на анализ картинок. Это позволяет работать даже небольшим локальным моделям.
Базовые действия fantoma закрывает собственным кодом без обращения к языковой модели: заполняет формы входа и отмечает чекбоксы. Сессии сохраняются в зашифрованном виде, поэтому авторизация остаётся активной между запросами. Если страница выдала проверку на бота или заглушку авторизации, инструмент сразу сообщает об этом статусом blocked.
Инструментам fantoma_read и fantoma_login не нужен внешний ИИ, однако для задач fantoma_run и fantoma_extract придётся задать адрес совместимой модели через переменную FANTOMA_LLM_URL. Серверу требуется Python 3.10+ и запуск на Linux либо macOS, а под Windows понадобится WSL.
Какие задачи решает
- читать веб-страницы в виде чистого Markdown без передачи скриншотов
- заполнять формы авторизации без участия языковой модели
- снизить расход токенов контекста при автоматизации браузера
- обнаруживать блокировки сайтов и бот-челленджи
Примеры запросов агенту
- Открой через fantoma страницу https://news.ycombinator.com и верни текст в Markdown
- Авторизуйся на https://github.com/login через fantoma_login, используя мои учётные данные
- Проверь ссылку https://example.com/pricing на наличие формы входа или защиты от ботов
Как установить fantoma
Командой платформы
claude mcp add fantoma -- uvx fantomauvx запускает команду с именем пакета; если в README она другая — uvx --from fantoma <команда>
Командой платформы
codex mcp add fantoma -- uvx fantomauvx запускает команду с именем пакета; если в README она другая — uvx --from fantoma <команда>
Файл настроек
{
"mcpServers": {
"fantoma": {
"command": "uvx",
"args": [
"fantoma"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from fantoma <команда>
Файл настроек
{
"servers": {
"fantoma": {
"type": "stdio",
"command": "uvx",
"args": [
"fantoma"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from fantoma <команда>
Командой платформы
gemini mcp add fantoma uvx fantomauvx запускает команду с именем пакета; если в README она другая — uvx --from fantoma <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fantoma
Как установить fantoma в Claude Code?
Выполните команду claude mcp add fantoma -- uvx fantoma. Браузер Camoufox загрузится автоматически при первом запуске.
Зачем нужен MCP-сервер fantoma?
Он позволяет моделям взаимодействовать с сайтами через дерево доступности вместо скриншотов. Это снижает расход токенов до 500 на шаг и позволяет автоматизировать страницы локальными моделями.
Нужна ли языковая модель для чтения страниц и авторизации?
Нет, инструменты fantoma_read и fantoma_login работают программно без вызова нейросетей. Языковая модель требуется только для свободных сценариев через fantoma_run и fantoma_extract.
