PyMemoryEditor

PyMemoryEditor

一个纯 Python 库（基于 ctypes），只需几行 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 用例。
• 🔬 调试与内省 — 无需附加调试器即可检查实时状态。
• 📊 可观测性工具 — 对运行中进程的变量采样，用于遥测。
• 🔐 安全与逆向工程研究 — 仅限你拥有或获授权测试的系统。
• 🎓 学习 — 捆绑提供的应用是学习内存扫描原理的绝佳教学工具。

说明

负责任地使用。 PyMemoryEditor 通过操作系统级 API 与其他进程交互。 仅对你拥有或获得明确授权检查的进程使用。

---

🤝 贡献

非常欢迎提交拉取请求、错误报告和功能创意。请阅读 CONTRIBUTING.md，了解开发环境设置、测试布局以及 需要注意的少量平台特定特性。

如果 PyMemoryEditor 对你的项目有所帮助，请给仓库点个 ⭐ — 这是支持项目开发并帮助其他人发现此库的最简单方式。

---

许可证

基于 MIT License 发布 — 可免费用于个人和商业用途。