CPU Performance Engineering — MCP-сервер для Claude Code: запуск
Подключает к ассистенту базу знаний по низкоуровневой оптимизации: индексирует статьи, разбирает отчёты perf stat и объясняет диагностику компиляторов со ссылками на источники.
claude mcp add cpu-perf -- uvx cpu-perfЧто делает CPU Performance Engineering
Сервер превращает репозиторий по низкоуровневой оптимизации процессоров в локальную поисковую базу для ассистента. Внутри собраны четырнадцать бенчмарков с замерами и редакционные правила отбора литературы. При первом запуске инструмент выкачивает материалы по ссылкам из документации, парсит PDF с arXiv и руководства вендоров, формируя полнотекстовый индекс с номерами страниц.
Инструмент разбирает сырой контекст профилировщика без участия внешней нейросети. Он рассчитывает метрики из вывода perf stat, учитывает архитектуры P-ядер и E-ядер, подсвечивает уровни Top-down по порогам Intel и разбирает причины отказа векторизации в gcc и clang. Ответы возвращаются в Markdown со ссылками на первоисточники.
Для работы нужен uv или Python. Первый запуск требует времени на выкачивание зависимостей и сборку индекса, из-за чего клиенты могут отвалиться по таймауту. Разработчик рекомендует заранее выполнить команду uvx cpu-perf --version в терминале.
Какие задачи решает
- разобрать вывод
perf statс расчётом метрик IPC и промахов кэша - найти причины отказа компилятора от автовекторизации циклов
- проверить аппаратные события по официальным руководствам Intel, AMD и Arm
- оценить узкие места процессора по методологии Top-down
Примеры запросов агенту
- Вот мой вывод
perf stat -j, подскажи, во что именно упирается исполнение программы. - Компилятор clang выдал
-Rpass-missedна цикле, как переписать структуру доступа к памяти? - Объясни, за что отвечает счётчик
cycle_activity.stalls_l3_missна архитектуре Intel.
Как установить CPU Performance Engineering
Командой платформы
claude mcp add cpu-perf -- uvx cpu-perfuvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>
Командой платформы
codex mcp add mcp -- uvx cpu-perfuvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"cpu-perf"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"cpu-perf"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>
Командой платформы
gemini mcp add mcp uvx cpu-perfuvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о CPU Performance Engineering
Как установить CPU Performance Engineering в Claude Code?
В терминале выполните команду claude mcp add cpu-perf -- uvx cpu-perf.
Что делает CPU Performance Engineering?
Сервер парсит отчёты профилировщика perf stat, выявляет узкие места конвейера и сверяет поведение кода с техническими руководствами производителей процессоров.
Почему первый запуск сервера может завершиться ошибкой?
Инструмент выкачивает внешние зависимости и строит локальный индекс документации. Чтобы среда разработки не закрыла процесс по таймауту, выполните uvx cpu-perf --version в консоли перед подключением.
