Memory Scanner MCP

基于 pymem 的内存扫描与修改 MCP 服务器。

通过 MCP 协议将内存读写、扫描、特征码搜索等能力暴露给 AI Agent，实现自然语言驱动的内存修改。

功能

支持的数据类型

int8 int16 int32 int64 uint8 uint16 uint32 uint64 float double string bytes

安装

从源码安装（推荐开发使用）

git clone https://github.com/miloira/MemoryScaner.git
cd MemoryScaner
pip install -e .

直接安装

pip install memory-scanner-mcp

需要 Python 3.10+，仅支持 Windows。

使用方式

作为命令行工具运行

memory-scanner-mcp

作为 Python 模块运行

python -m memory_scanner

MCP 客户端配置

推荐使用 uvx（无需手动安装）：

{
  "mcpServers": {
    "memory-scanner": {
      "command": "uvx",
      "args": ["memory-scanner-mcp"]
    }
  }
}

也可以先 pip install 后直接使用命令：

{
  "mcpServers": {
    "memory-scanner": {
      "command": "memory-scanner-mcp"
    }
  }
}

或者使用 Python 模块方式：

{
  "mcpServers": {
    "memory-scanner": {
      "command": "python",
      "args": ["-m", "memory_scanner"]
    }
  }
}

项目结构

MemoryScaner/
├── pyproject.toml          # 项目配置与依赖管理
├── README.md
├── LICENSE
└── src/
    └── memory_scanner/
        ├── __init__.py     # 包初始化与版本号
        ├── __main__.py     # python -m memory_scanner 入口
        └── server.py       # MCP 服务器实现（所有工具定义）

使用示例

典型的内存修改流程（以游戏修改为例）：

1. 附加进程: "附加到 game.exe"
2. 首次扫描: "搜索 int32 类型的值 100"（当前血量为100）
3. 改变值: 在游戏中让血量变化
4. 再次扫描: "搜索新的值 95"（血量变为95）
5. 重复缩小: 直到结果只剩1-2个
6. 修改值: "把找到的地址写入 9999"
7. 冻结: "冻结这个地址为 9999"

开发

# 克隆项目
git clone https://github.com/miloira/MemoryScaner.git
cd MemoryScaner

# 创建虚拟环境
python -m venv .venv
.venv\Scripts\activate

# 安装开发依赖（可编辑模式）
pip install -e .

注意事项

• 必须以 管理员权限 运行才能读写其他进程的内存
• 部分进程有保护机制，可能无法正常读写
• 冻结功能需要客户端定期调用 apply_frozen 来维持
• 扫描大量内存时可能需要较长时间

许可证

MIT