OneTool MCP — MCP-сервер для Claude Code: инструменты как Python-код
Один MCP-сервер вместо десятка: агент вызывает поиск, базы, файлы и диаграммы Python-кодом, а не описаниями инструментов. Экономит окно контекста.
Открыть на GitHubЧто делает OneTool MCP
Обычный MCP-сервер на каждом запросе присылает определения своих инструментов. С подключёнными серверами контекст раздувается ещё до первого вопроса. OneTool переворачивает схему: MCP-сервер один, а инструменты доступны как функции Python внутри __onetool. Агент пишет код вызова, и промежуточные данные остаются переменными, не попадая в контекст.
Внутри 28 наборов и 253 инструмента: поиск Brave, Google и Tavily, документация Context7, работа с файлами и таблицами, SQL-базы, конвертация PDF и офисных файлов в Markdown, живые диаграммы Excalidraw, память с семантическим поиском. Отдельный слой умеет подключать ваши прежние MCP-серверы как прокси и включать или выключать их на ходу. Крупные результаты возвращаются в виде ручки, по которой их можно искать.
Нужен Python 3.12+ и пакет onetool-mcp из PyPI, ставится через uv. Есть демон, который держит соединения: CLI и API обращаются к уже запущенному процессу, поэтому без него часть команд не сработает. Конфиг по умолчанию берётся из ~/.onetool/onetool.yaml, и пути к нему придётся прописать в каждом MCP-клиенте руками через onetool init mcp-config.
Какие задачи решает
- ужать расход токенов при подключении нескольких MCP-серверов
- собрать поиск, документацию и базу в одном вызове агента
- читать содержимое файла по частям, не забивая контекст
- конвертировать PDF или Word в Markdown для разбора
- нарисовать схему архитектуры в формате, который открывается в draw.io
Примеры запросов агенту
- Найди через
__onetool brave.searchизменения в React 19 и запиши конспект в память - Прочитай оглавление
report.pdfчерезctx, потом достань нужный раздел - Переключись на проксирование сервера
githubи покажи, какие у него есть инструменты
Как установить OneTool MCP
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о OneTool MCP
Как установить OneTool MCP в Claude Code?
Поставьте пакет: uv tool install 'onetool-mcp[all]', затем выполните onetool init --config ~/.onetool. Напечатайте конфиг для клиента командой onetool init mcp-config --client claude-code и вставьте его в настройки Claude. Проверка: onetool init validate --config ~/.onetool/onetool.yaml.
Что делает OneTool MCP?
Поднимает один MCP-сервер, у которого 253 инструмента в 28 наборах: поиск, документация, файлы, базы, память, диаграммы. Агент обращается к ним как к функциям Python, поэтому определения инструментов не занимают окно контекста.
Чем OneTool отличается от обычного MCP-сервера?
Тот на каждом запросе заново передаёт описание своих инструментов. OneTool держит постоянный расход около 2K токенов независимо от числа подключённых наборов, а ваши старые серверы подключает через прокси.
