PyMemoryEditor

ctypes를 기반으로 만들어진 순수 Python 라이브러리로, 몇 줄의 Python 코드로 실행 중인 모든 프로세스의 메모리를 검사, 수정, 검색할 수 있습니다 — Windows, Linux, macOS에서 Cheat Engine 워크플로우를 구현하세요!

---

Python에서 바로 모든 프로세스의 메모리를 읽고, 쓰고, 스캔하세요.
하나의 통합 API. 세 가지 운영체제. C 컴파일러 불필요. 네이티브 빌드 단계 없음.

Windows · Linux · macOS에서 실행 — 32비트 및 64비트.

실행 중인 게임의 값 조정 · 라이브 프로그램의 상태 검사 · RAM에서 직접 데이터 수집.

---

설치

pip install PyMemoryEditor

번들로 제공되는 GUI 앱(Cheat Engine 스타일 스캐너)도 함께 설치하려면 app extra를 사용하세요:

pip install "PyMemoryEditor[app]"
pymemoryeditor

대규모 프로세스에서 더 빠른 스캔을 원하면 speed extra를 추가하세요. NumPy를 가져와 숫자 스캔 비교 루프를 자동으로 벡터화합니다 — 선택적 스캔에서 약 10~30배 빠릅니다:

pip install "PyMemoryEditor[speed]"

AI 어시스턴트가 Model Context Protocol을 통해 라이브러리를 구동하도록 하려면 mcp extra를 사용하세요 (아래 참조):

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

또는 mcpServers JSON을 읽는 모든 클라이언트(Claude Desktop, 에디터 등)에서:

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

14개의 도구가 전체 워크플로우를 커버하며, 스캔 결과는 핸들 뒤에 서버 측에 보관되므로 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는 OS 수준 API를 통해 다른 프로세스와 통신합니다. 소유하거나 검사할 명시적 권한이 있는 프로세스에만 사용하세요.

---

🤝 기여

풀 리퀘스트, 버그 리포트, 기능 아이디어를 환영합니다. 개발 환경 설정, 테스트 구조 및 알아두어야 할 소수의 플랫폼별 특이사항은 CONTRIBUTING.md를 읽어보세요.

PyMemoryEditor가 프로젝트에 도움이 되었다면, 저장소에 ⭐를 눌러주세요 — 작업을 지원하고 다른 사람들이 라이브러리를 발견하도록 돕는 가장 쉬운 방법입니다.

---

라이선스

MIT License로 배포됩니다 — 개인 및 상업적 사용이 무료입니다.