Fitter — MCP-сервер для Claude Code: сайты и API в JSON
MCP-сервер, который заставляет агента писать декларативные конфиги для сбора данных с сайтов и API и тут же их выполнять.
claude mcp add --env FITTER_PLUGINS=<FITTER_PLUGINS> --transport stdio fitter -- docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3Что делает Fitter
Fitter описывает источник данных и правила извлечения в одном JSON- или YAML-конфиге: HTTP-запрос, headless-браузер, файл или статичное значение — с одной стороны, JSON-пути, CSS-селекторы и XPath — с другой. Кода нет, поэтому конфиг может написать сам агент. Сервер отдаёт модели справочник по формату, инструмент проверки конфига и запуск, а вся загрузка идёт на вашей машине.
Инструментов шесть: fitter_run принимает конфиг строкой, fitter_run_file читает его из локального файла, fitter_run_url скачивает по HTTP(S). Отдельно стоит fitter_inspect_url — он вытаскивает из страницы структуру и подходящие селекторы, чтобы модель не угадывала их вслепую и не получала null. Ещё есть fitter_validate_config и fitter_config_reference.
Браузерные конфиги требуют Playwright: в бинарнике и .mcpb-сборке браузеров нет, HTTP, файловые и статичные коннекторы работают сразу. В коннекторе playwright можно поставить "install": true, и драйвер с браузером скачаются при первом запуске. Если ставите браузеры заранее, версия playwright-go должна совпадать с той, что в go.mod — иначе драйвер откажется работать. В образе ghcr.io/pxyup/fitter-mcp:playwright Chromium, Firefox и WebKit уже внутри.
Какие задачи решает
- собрать JSON со страницы, которую рисует JavaScript
- описать сбор данных конфигом вместо скрипта на Python
- проверить конфиг до запуска и не ловить null в полях
- переиспользовать удачный конфиг как регулярную задачу
- вытащить данные из API по JSON-путям без ручного разбора
Примеры запросов агенту
- Собери топ-5 историй с HackerNews с заголовками и очками через fitter
- Запусти
examples/config_morning_briefing.jsonчерез fitter и дай мне сводку - Посмотри структуру этой страницы через fitter и предложи селекторы для цен
Как установить Fitter
Командой платформы
claude mcp add --env FITTER_PLUGINS=<FITTER_PLUGINS> --transport stdio fitter -- docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3Вместо <…> подставьте свои значения
Командой платформы
codex mcp add fitter --env FITTER_PLUGINS=<FITTER_PLUGINS> -- docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"fitter": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FITTER_PLUGINS",
"ghcr.io/pxyup/fitter-mcp:v1.8.3"
],
"env": {
"FITTER_PLUGINS": "<FITTER_PLUGINS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"fitter": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FITTER_PLUGINS",
"ghcr.io/pxyup/fitter-mcp:v1.8.3"
],
"env": {
"FITTER_PLUGINS": "<FITTER_PLUGINS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FITTER_PLUGINS=<FITTER_PLUGINS> fitter docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Fitter
Как установить Fitter в Claude Code?
Зарегистрируйте сервер одной командой: claude mcp add --env FITTER_PLUGINS=<FITTER_PLUGINS> --transport stdio fitter -- docker run -i --rm -e FITTER_PLUGINS ghcr.io/pxyup/fitter-mcp:v1.8.3. После этого он доступен во всех проектах.
Что делает Fitter?
Превращает сайт или API в структурированный JSON по декларативному конфигу. Агент сам пишет конфиг, проверяет его и запускает, а данные загружаются локально.
Нужен ли Playwright для работы Fitter?
Только для конфигов с коннектором playwright. HTTP, файловые и статичные коннекторы работают без браузеров; в образе ghcr.io/pxyup/fitter-mcp:playwright они уже установлены.
