# CPU Performance Engineering

Подключает к ассистенту базу знаний по низкоуровневой оптимизации: индексирует статьи, разбирает отчёты perf stat и объясняет диагностику компиляторов со ссылками на источники.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 1169
- Автор: usamahz
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/usamahz/cpu-performance-engineering/tree/HEAD/misc/mcp
- Обновлён: 2026-10-08
- HTML: https://affpapa.org/nevibecode/mcp/cpu-performance-engineering

## Что делает

Сервер превращает репозиторий по низкоуровневой оптимизации процессоров в локальную поисковую базу для ассистента. Внутри собраны четырнадцать бенчмарков с замерами и редакционные правила отбора литературы. При первом запуске инструмент выкачивает материалы по ссылкам из документации, парсит PDF с arXiv и руководства вендоров, формируя полнотекстовый индекс с номерами страниц.

Инструмент разбирает сырой контекст профилировщика без участия внешней нейросети. Он рассчитывает метрики из вывода `perf stat`, учитывает архитектуры P-ядер и E-ядер, подсвечивает уровни Top-down по порогам Intel и разбирает причины отказа векторизации в gcc и clang. Ответы возвращаются в Markdown со ссылками на первоисточники.

Для работы нужен `uv` или Python. Первый запуск требует времени на выкачивание зависимостей и сборку индекса, из-за чего клиенты могут отвалиться по таймауту. Разработчик рекомендует заранее выполнить команду `uvx cpu-perf --version` в терминале.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add cpu-perf -- uvx cpu-perf
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp -- uvx cpu-perf
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "uvx",
            "args": [
                "cpu-perf"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "cpu-perf"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add mcp uvx cpu-perf
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from cpu-perf <команда>

## Когда брать
- разобрать вывод `perf stat` с расчётом метрик IPC и промахов кэша
- найти причины отказа компилятора от автовекторизации циклов
- проверить аппаратные события по официальным руководствам Intel, AMD и Arm
- оценить узкие места процессора по методологии Top-down

## Примеры запросов агенту
- Вот мой вывод `perf stat -j`, подскажи, во что именно упирается исполнение программы.
- Компилятор clang выдал `-Rpass-missed` на цикле, как переписать структуру доступа к памяти?
- Объясни, за что отвечает счётчик `cycle_activity.stalls_l3_miss` на архитектуре Intel.

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872
- [AIHawk](https://affpapa.org/nevibecode/mcp/aihawk.md) — MCP-сервер · ★ 32221

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md