PyMemoryEditor

Чистая библиотека на Python (построенная на ctypes), которая позволяет исследовать, изменять и искать в памяти любого запущенного процесса всего в несколько строк Python — рабочие процессы Cheat Engine на Windows, Linux и macOS!

Читайте, записывайте и сканируйте память любого процесса — прямо из Python.
Единый API. Три операционные системы. Без компилятора C. Без этапа нативной сборки.

Работает на Windows · Linux · macOS — 32-бит и 64-бит.

PyMemoryEditor app attached to a running process

Измените значение в запущенной игре · исследуйте состояние работающей программы · извлекайте данные прямо из оперативной памяти.

Установка

pip install PyMemoryEditor

Чтобы также установить встроенное GUI-приложение (сканер в стиле Cheat Engine), используйте дополнительный пакет app:

pip install "PyMemoryEditor[app]"
pymemoryeditor

Для более быстрого сканирования больших процессов добавьте дополнительный пакет speed. Он подтягивает NumPy и автоматически векторизует цикл сравнения при числовом сканировании — примерно в 10–30 раз быстрее при выборочных сканированиях:

pip install "PyMemoryEditor[speed]"

Чтобы позволить AI-ассистенту управлять библиотекой через Model Context Protocol, используйте дополнительный пакет mcp (см. ниже):

pip install "PyMemoryEditor[mcp]"

📖 Полное руководство на Read the Docs.

Посмотрите в действии

from PyMemoryEditor import OpenProcess

with OpenProcess(name="game.exe") as process:

    # Scan the whole process for every address holding the value 100.
    for address in process.search_by_value(int, value=100):
        print(f"Found at 0x{address:X}")

    # Read the current value, then write a new one back.
    current = process.read_int(address)
    process.write_int(address, current + 500)

Вот и всё — читайте, записывайте или сканируйте другой процесс в три строки, одинаково на каждой платформе.

Пусть это сделает AI-ассистент (MCP)

PyMemoryEditor поставляется с сервером Model Context Protocol, так что AI-ассистент может выполнить весь цикл самостоятельно:

«Найди значение здоровья в моей игре. Сейчас оно равно 100.»

Он сканирует, просит вас получить урон, уточняет совпадения и выдаёт вам адрес.

pip install "PyMemoryEditor[mcp]"
claude mcp add pymemoryeditor -- pymemoryeditor-mcp

Или в любом клиенте, который читает JSON mcpServers (Claude Desktop, редакторы, …):

{
  "mcpServers": {
    "pymemoryeditor": {
      "command": "pymemoryeditor-mcp",
      "args": []
    }
  }
}

Четырнадцать инструментов покрывают весь рабочий процесс, а результаты сканирования хранятся на стороне сервера за дескриптором, поэтому первое сканирование с 40 000 совпадений стоит несколько токенов вместо всего вашего контекста.

Подробнее читайте в руководстве по MCP.

📖 Документация

Полная документация находится на pymemoryeditor.readthedocs.io — установка, рабочий процесс Cheat Engine, каждый метод и параметр, руководство по GUI-приложению, заметки по платформам и устранение неполадок.

Краткая карта, куда обратиться:

Быстрый старт	Откройте процесс, читайте, записывайте и запустите первое сканирование.
Поиск в памяти	Сканирование значений, диапазоны, уточнение результатов, цикл Cheat Engine.
Сканирование по шаблону	Поиск кода/данных по байтовым сигнатурам (AOB) и регулярным выражениям.
Указатели	Многоуровневые цепочки указателей и живой `RemotePointer`.
Сканирование указателей	Поиск статических указателей, переживающих ASLR.
GUI-приложение	Встроенный сканер в стиле Cheat Engine.
Сервер MCP	Позвольте AI-ассистенту управлять циклом сканирования/уточнения.
Справочник API	Каждый публичный класс, метод и параметр.
Заметки по платформам	Разрешения и особенности на Windows, Linux и macOS.
Устранение неполадок	Распространённые ошибки и способы их исправления.

Что можно с этим создать?

🎮 Инструменты для моддинга игр и спидраннинга — классический сценарий использования Cheat Engine.
🔬 Отладка и интроспекция — исследуйте живое состояние без подключения отладчика.
📊 Инструменты наблюдаемости — снимайте значения переменных в работающем процессе для телеметрии.
🔐 Исследования в области безопасности и реверс-инжиниринга — на системах, которыми вы владеете или которые вам разрешено тестировать.
🎓 Обучение — встроенное приложение — отличный учебный инструмент для понимания того, как работает сканирование памяти.

[!NOTE] Ответственное использование. PyMemoryEditor взаимодействует с другими процессами через API уровня ОС. Направляйте его только на процессы, которыми вы владеете или которые вам явно разрешено исследовать.

PyMemoryEditor v2.2.0