uniprof — MCP-сервер для Claude Code: что делает и как установить
Запускает профилирование CPU без правок в кодовой базе и собирает статистику по узким местам в едином формате. Пригодится агентам для поиска медленных участков.
claude mcp add uniprof -- npx -y uniprofЧто делает uniprof
Сервер объединяет профилировщики под разные окружения: py-spy для Python 3.7+, 0x для Node.js 14+ и async-profiler для Java 8+. Поддерживаются также Ruby, PHP, .NET и нативный код. Инструмент сам определяет рантайм по переданной команде, выполняет запуск и сводит разрозненные отчёты к единой структуре.
По умолчанию запуск происходит внутри изолированных контейнеров Docker, чтобы не требовать настройки прав в системе. Доступен и прямой режим с флагом --mode host, когда утилиты установлены локально. Нативные бинарники Mach-O для macOS не работают в контейнере из-за привязки Instruments к хосту.
Для точного разбора стека нативным программам понадобятся отладочные символы вроде DWARF и сохранение указателей фрейма. Поддержки хостовой Windows нет, но можно использовать WSL2.
Какие задачи решает
- найти узкие места по нагрузке на процессор без добавления библиотек в проект
- запустить сбор профиля выполнения для скрипта на Python, Node.js или Ruby
- свести разные форматы отчётов профилировщиков к единому виду
- выгрузить данные работы программы для построения флеймграфа
Примеры запросов агенту
- Сделай профилирование процессора для
python app.pyи покажи самые медленные функции - Запусти
node server.jsчерез uniprof и запиши профиль в файлprofile.json - Проанализируй файл
profile.jsonи найди участки кода с максимальной нагрузкой
Как установить uniprof
Командой платформы
claude mcp add uniprof -- npx -y uniprofКомандой платформы
codex mcp add uniprof -- npx -y uniprofФайл настроек
{
"mcpServers": {
"uniprof": {
"command": "npx",
"args": [
"-y",
"uniprof"
]
}
}
}Файл настроек
{
"servers": {
"uniprof": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"uniprof"
]
}
}
}Командой платформы
gemini mcp add uniprof npx -y uniprofПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о uniprof
Как установить uniprof в Claude Code?
Выполните команду claude mcp add uniprof -- npx -y uniprof. При наличии глобального пакета также работает встроенный установщик uniprof mcp install claudecode.
Что делает uniprof?
Сервер позволяет ИИ-ассистенту запускать замеры нагрузки на процессор для разных языков программирования без изменения исходного кода. Он нормализует результаты разных утилит и выявляет ресурсоёмкие участки приложения.
Нужен ли Docker для работы uniprof?
По умолчанию да: утилита предпочитает запускать профилировщики в изолированных контейнерах Docker. Если на машине уже настроены нужные системные профилировщики, можно переключиться на прямое исполнение с флагом --mode host.
