TinySearch MCP
Локальный веб-поиск для агентов: ищет, читает страницы и отдает сжатые фрагменты с источниками, экономя токены контекста
- 236 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер ходит в интернет от вашего имени, открывает страницы и работает с браузерными сессиями, куда могут попасть вводимые данные
- Полный вариант на Docker поднимает SearXNG и сетевой порт для MCP
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/tinysearchОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер ходит в интернет от вашего имени, открывает страницы и работает с браузерными сессиями, куда могут попасть вводимые данные
- Полный вариант на Docker поднимает SearXNG и сетевой порт для MCP
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TinySearch выполняет работу с веб-страницами до модели. Он ищет по сети, открывает лучшие страницы, убирает навигацию и шаблонный текст, ранжирует фрагменты локально и возвращает агенту только доказательства со ссылками на источники. Модель платит токенами за нужные абзацы, а не за целые страницы. TinySearch входит в набор TinySuite, цель которого сделать работу агентов дешевле. Инструменты MCP: `search(items)` быстро находит источники без обхода и переранжирования, `scrape_urls(items)` читает от одной до пяти известных страниц с бюджетом токенов, `browser_navigate` и `browser_act` работают со страницами, которым нужно взаимодействие, а `get_current_datetime()` отвечает на вопросы о времени. Для каждого подключения у интерактивных инструментов свой браузер и своя страница, так что клиенты не видят вкладки и cookie друг друга. Три способа запуска: библиотека Python, один `uvx` для MCP-клиента и Docker с SearXNG и HTTP.
Для кого. Разработчикам агентов, которые платят за токены и хотят искать в вебе без платных API поиска и без выгрузки страниц целиком в контекст.
Подходит, если
- Исследовательский агент собирает факты по теме и должен уложиться в небольшой бюджет токенов контекста
- Нужен поиск без платного провайдера: по умолчанию работает через DDGS, а полный вариант через SearXNG
- Страница показывает данные после клика, и агент проходит ее через `browser_act`
- Несколько клиентов делят один сервер, и браузеры у них изолированы друг от друга
Не подходит, если
- Нужен собственный постоянный индекс веба: TinySearch ничего не хранит как поисковик
- Требуется агент или чат: это слой поиска, а не отдельный агент или интерфейс
- Достаточно браузерного поиска от модели: отдельный сервер лишний при редких запросах
Пример запроса к агенту
Найди три независимых источника о новом релизе библиотеки, прочитай их и дай короткую сводку со ссылками на каждыйMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
TinySearch остается слоем поиска и не заменяет агента, интерфейс чата или постоянный индекс. Уровни 1 и 2 используют DDGS и не требуют сервиса поиска, для полной локальной схемы нужен уровень 3 с Docker, SearXNG и постоянным хранилищем моделей. Одновременно работают не больше четырех интерактивных браузерных сессий (`browser_max_sessions`), новый вызывающий ждет до 30 секунд. Страницы читаются без гарантии доступа к закрытым сайтам. Версия в реестре MCP 0.6.8, лицензия MIT.
Как отключить. Удалите блок tinysearch из конфигурации клиента, остановите контейнер `docker compose down`, если запускали полный вариант, и удалите пакет `tinysuite-search`.
Частые вопросы
Как запустить TinySearch для MCP-клиента?
Командой `uvx --from "tinysuite-search[server]" tinysearch`: клиент сам запустит сервер. Поиск идет через DDGS и не требует отдельного сервиса.
Чем отличаются три способа запуска?
Библиотека Python (`pip install tinysuite-search`) для встраивания, одна команда `uvx` для MCP-клиента и Docker с SearXNG, постоянным хранилищем моделей и сетевым MCP по HTTP.
Какие инструменты есть у сервера?
`search`, `scrape_urls`, `browser_navigate`, `browser_act` и `get_current_datetime`. Полные параметры описаны в справочнике на tinysuite.dev.
Как TinySearch экономит токены?
Возвращает только лучшие фрагменты в пределах бюджета доказательств, а не страницы целиком, и ранжирует их локально. Бесплатный поиск через DDGS убирает плату за метрируемый API.
Изолированы ли браузерные сессии?
Да, для каждого подключения MCP создаются свой браузер и страница, поэтому клиенты не видят вкладки и cookie друг друга. Параллельно работают не больше четырех сессий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер без ключей API: поиск по нескольким системам, загрузка страниц и чтение документов для LLM.
MCP-сервер объединенного поиска: один интерфейс к Tavily, Brave, Kagi, Exa, Linkup, Firecrawl и поиску по GitHub
MCP-сервер для веб-поиска в реальном времени: общий и тематический поиск, пакетные запросы и извлечение содержимого страниц
MCP-сервер с поиском DuckDuckGo и извлечением текста страниц: можно передать сразу несколько адресов
SearXNG AI Kit дает агентам веб-поиск по 180 с лишним движкам через CLI и MCP-сервер, без ключа поискового API
Метапоиск для агентов: один MCP-сервер и HTTP API собирают результаты многих поисковиков в единый JSON с дедупликацией.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| TinySearch (эта карточка) | нет | не нужна | 236 | |
| Context7 | да | API-ключ | 64 656 | документация библиотек по запросу, а не поиск по открытому вебу и чтение страниц |
| MCP Local RAG | нет | не нужна | 430 | поиск по вашим локальным документам, а не по вебу |
Коротко о README
Текст обещает тратить токены на ответы, а не на веб-страницы, и показывает конвейер: поиск и обход, локальное ранжирование, компактные доказательства. Затем идут три уровня установки, объяснение, чем TinySearch снижает расходы, и таблица инструментов MCP.