memory-scanner-mcp 0.0.1__tar.gz

memory_scanner_mcp-0.0.1/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

memory_scanner_mcp-0.0.1/.kiro/settings/mcp.json

@@ -0,0 +1,24 @@
+{
+  "mcpServers": {
+    "memory-scanner": {
+      "command": "python",
+      "args": [
+        "memory_scanner_mcp.py"
+      ],
+      "cwd": "c:\\Users\\张明明\\Desktop\\github\\MemoryScaner",
+      "disabled": false,
+      "autoApprove": [
+        "list_processes",
+        "scan_memory_first",
+        "attach_process",
+        "dump_memory",
+        "read_memory",
+        "read_memory",
+        "read_memory",
+        "read_memory",
+        "read_memory",
+        "read_memory"
+      ]
+    }
+  }
+}

memory_scanner_mcp-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 miloira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

memory_scanner_mcp-0.0.1/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: memory-scanner-mcp
+Version: 0.0.1
+Summary: 基于 pymem 的内存扫描与修改 MCP 服务器，支持进程内存读写、扫描、模式搜索等功能
+Project-URL: Homepage, https://github.com/miloira/MemoryScaner
+Project-URL: Repository, https://github.com/miloira/MemoryScaner
+Project-URL: Issues, https://github.com/miloira/MemoryScaner/issues
+Author: miloira
+License-Expression: MIT
+License-File: LICENSE
+Keywords: mcp,memory,process,pymem,scanner
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: pymem>=1.13.1
+Description-Content-Type: text/markdown
+
+# Memory Scanner MCP
+
+基于 [pymem](https://github.com/srounet/Pymem) 的内存扫描与修改 MCP 服务器。
+
+通过 MCP 协议将内存读写、扫描、特征码搜索等能力暴露给 AI Agent，实现自然语言驱动的内存修改。
+
+## 功能
+
+| 工具 | 说明 |
+|------|------|
+| `list_processes` | 列出运行中的进程 |
+| `attach_process` | 附加到目标进程 |
+| `detach_process` | 断开进程连接 |
+| `get_process_info` | 获取进程详细信息和模块列表 |
+| `read_memory` | 读取指定地址的值 |
+| `write_memory` | 写入值到指定地址 |
+| `scan_memory_first` | 首次扫描（全内存搜索） |
+| `scan_memory_next` | 再次扫描（缩小范围） |
+| `scan_memory_filter` | 条件过滤（大于/小于等） |
+| `write_scan_results` | 批量写入扫描结果 |
+| `get_scan_results` | 查看扫描结果及当前值 |
+| `scan_pattern` | AOB/特征码扫描（支持通配符） |
+| `get_module_base` | 获取模块基地址 |
+| `read_pointer_chain` | 多级指针链读取 |
+| `write_pointer_chain` | 多级指针链写入 |
+| `dump_memory` | 内存转储（Hex + ASCII） |
+| `freeze_address` | 冻结地址值 |
+| `unfreeze_address` | 解除冻结 |
+| `apply_frozen` | 执行冻结写入 |
+| `list_frozen` | 列出冻结列表 |
+
+## 支持的数据类型
+
+`int8` `int16` `int32` `int64` `uint8` `uint16` `uint32` `uint64` `float` `double` `string` `bytes`
+
+## 安装
+
+### 从源码安装（推荐开发使用）
+
+```bash
+git clone https://github.com/miloira/MemoryScaner.git
+cd MemoryScaner
+pip install -e .
+```
+
+### 直接安装
+
+```bash
+pip install memory-scanner-mcp
+```
+
+> 需要 Python 3.10+，仅支持 Windows。
+
+## 使用方式
+
+### 作为命令行工具运行
+
+```bash
+memory-scanner-mcp
+```
+
+### 作为 Python 模块运行
+
+```bash
+python -m memory_scanner
+```
+
+### MCP 客户端配置
+
+推荐使用 `uvx`（无需手动安装）：
+
+```json
+{
+  "mcpServers": {
+    "memory-scanner": {
+      "command": "uvx",
+      "args": ["memory-scanner-mcp"]
+    }
+  }
+}
+```
+
+也可以先 `pip install` 后直接使用命令：
+
+```json
+{
+  "mcpServers": {
+    "memory-scanner": {
+      "command": "memory-scanner-mcp"
+    }
+  }
+}
+```
+
+或者使用 Python 模块方式：
+
+```json
+{
+  "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"
+
+## 开发
+
+```bash
+# 克隆项目
+git clone https://github.com/miloira/MemoryScaner.git
+cd MemoryScaner
+
+# 创建虚拟环境
+python -m venv .venv
+.venv\Scripts\activate
+
+# 安装开发依赖（可编辑模式）
+pip install -e .
+```
+
+## 注意事项
+
+- 必须以 **管理员权限** 运行才能读写其他进程的内存
+- 部分进程有保护机制，可能无法正常读写
+- 冻结功能需要客户端定期调用 `apply_frozen` 来维持
+- 扫描大量内存时可能需要较长时间
+
+## 许可证
+
+MIT

memory_scanner_mcp-0.0.1/README.md

@@ -0,0 +1,158 @@
+# Memory Scanner MCP
+
+基于 [pymem](https://github.com/srounet/Pymem) 的内存扫描与修改 MCP 服务器。
+
+通过 MCP 协议将内存读写、扫描、特征码搜索等能力暴露给 AI Agent，实现自然语言驱动的内存修改。
+
+## 功能
+
+| 工具 | 说明 |
+|------|------|
+| `list_processes` | 列出运行中的进程 |
+| `attach_process` | 附加到目标进程 |
+| `detach_process` | 断开进程连接 |
+| `get_process_info` | 获取进程详细信息和模块列表 |
+| `read_memory` | 读取指定地址的值 |
+| `write_memory` | 写入值到指定地址 |
+| `scan_memory_first` | 首次扫描（全内存搜索） |
+| `scan_memory_next` | 再次扫描（缩小范围） |
+| `scan_memory_filter` | 条件过滤（大于/小于等） |
+| `write_scan_results` | 批量写入扫描结果 |
+| `get_scan_results` | 查看扫描结果及当前值 |
+| `scan_pattern` | AOB/特征码扫描（支持通配符） |
+| `get_module_base` | 获取模块基地址 |
+| `read_pointer_chain` | 多级指针链读取 |
+| `write_pointer_chain` | 多级指针链写入 |
+| `dump_memory` | 内存转储（Hex + ASCII） |
+| `freeze_address` | 冻结地址值 |
+| `unfreeze_address` | 解除冻结 |
+| `apply_frozen` | 执行冻结写入 |
+| `list_frozen` | 列出冻结列表 |
+
+## 支持的数据类型
+
+`int8` `int16` `int32` `int64` `uint8` `uint16` `uint32` `uint64` `float` `double` `string` `bytes`
+
+## 安装
+
+### 从源码安装（推荐开发使用）
+
+```bash
+git clone https://github.com/miloira/MemoryScaner.git
+cd MemoryScaner
+pip install -e .
+```
+
+### 直接安装
+
+```bash
+pip install memory-scanner-mcp
+```
+
+> 需要 Python 3.10+，仅支持 Windows。
+
+## 使用方式
+
+### 作为命令行工具运行
+
+```bash
+memory-scanner-mcp
+```
+
+### 作为 Python 模块运行
+
+```bash
+python -m memory_scanner
+```
+
+### MCP 客户端配置
+
+推荐使用 `uvx`（无需手动安装）：
+
+```json
+{
+  "mcpServers": {
+    "memory-scanner": {
+      "command": "uvx",
+      "args": ["memory-scanner-mcp"]
+    }
+  }
+}
+```
+
+也可以先 `pip install` 后直接使用命令：
+
+```json
+{
+  "mcpServers": {
+    "memory-scanner": {
+      "command": "memory-scanner-mcp"
+    }
+  }
+}
+```
+
+或者使用 Python 模块方式：
+
+```json
+{
+  "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"
+
+## 开发
+
+```bash
+# 克隆项目
+git clone https://github.com/miloira/MemoryScaner.git
+cd MemoryScaner
+
+# 创建虚拟环境
+python -m venv .venv
+.venv\Scripts\activate
+
+# 安装开发依赖（可编辑模式）
+pip install -e .
+```
+
+## 注意事项
+
+- 必须以 **管理员权限** 运行才能读写其他进程的内存
+- 部分进程有保护机制，可能无法正常读写
+- 冻结功能需要客户端定期调用 `apply_frozen` 来维持
+- 扫描大量内存时可能需要较长时间
+
+## 许可证
+
+MIT

memory_scanner_mcp-0.0.1/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "memory-scanner-mcp"
+version = "0.0.1"
+description = "基于 pymem 的内存扫描与修改 MCP 服务器，支持进程内存读写、扫描、模式搜索等功能"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "miloira" },
+]
+keywords = ["mcp", "memory", "scanner", "pymem", "process"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Debuggers",
+]
+dependencies = [
+    "pymem>=1.13.1",
+    "mcp>=1.0.0",
+    "psutil>=5.9.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/miloira/MemoryScaner"
+Repository = "https://github.com/miloira/MemoryScaner"
+Issues = "https://github.com/miloira/MemoryScaner/issues"
+
+[project.scripts]
+memory-scanner-mcp = "memory_scanner.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/memory_scanner"]

memory_scanner_mcp-0.0.1/src/memory_scanner/__init__.py

@@ -0,0 +1,6 @@
+"""
+Memory Scanner MCP Server
+基于 pymem 的内存扫描与修改 MCP 服务器
+"""
+
+__version__ = "0.0.1"

memory_scanner_mcp-0.0.1/src/memory_scanner/__main__.py

@@ -0,0 +1,9 @@
+"""Allow running as: python -m memory_scanner"""
+
+from memory_scanner.server import mcp
+
+def main():
+    mcp.run(transport="stdio")
+
+if __name__ == "__main__":
+    main()