ida-pro-mcp-xjoker 1.0.1__py3-none-any.whl → 1.0.2__py3-none-any.whl

ida_pro_mcp/ida_mcp/api_analysis.py

@@ -13,6 +13,7 @@ import ida_idaapi
 import ida_xref
 import ida_ua
 import ida_name
+import ida_idp
 from .rpc import tool
 from .sync import idasync, tool_timeout
 from .cache import decompile_cache, xrefs_cache
@@ -503,7 +504,8 @@ def callees(
                         break
                     current_ea = next_ea
                     continue
-                if insn.itype in [idaapi.NN_call, idaapi.NN_callfi, idaapi.NN_callni]:
+                # Use architecture-independent call instruction detection
+                if ida_idp.is_call_insn(insn):
                     op0 = insn.ops[0]
                     if op0.type in (ida_ua.o_mem, ida_ua.o_near, ida_ua.o_far):
                         target = op0.addr

ida_pro_mcp/ida_mcp/api_core.py

@@ -10,7 +10,7 @@ import ida_nalt
 
 from .rpc import tool
 from .sync import idasync
-from .cache import function_cache, string_cache
+from .cache import function_cache
 
 # Cached strings list: [(ea, text), ...]
 _strings_cache: list[tuple[int, str]] | None = None

ida_pro_mcp/ida_mcp/auth.py

@@ -3,11 +3,14 @@
 Provides authentication middleware for MCP server with support for:
 - Bearer token authentication (Authorization: Bearer <key>)
 - X-API-Key header authentication
+- Environment variable expansion (${ENV_VAR} syntax)
 - Timing-attack resistant comparison
 """
 
 import hmac
 import logging
+import os
+import re
 from typing import Optional, Callable
 
 logger = logging.getLogger(__name__)
@@ -18,6 +21,33 @@ AUTH_EXEMPT_PATHS = frozenset({
     "/config.html",
 })
 
+# Pattern to match ${ENV_VAR} syntax
+_ENV_VAR_PATTERN = re.compile(r"^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$")
+
+
+def resolve_env_var(value: Optional[str]) -> Optional[str]:
+    """Resolve environment variable reference in ${VAR} format.
+
+    Args:
+        value: The value to resolve, may be a literal or ${ENV_VAR} reference
+
+    Returns:
+        The resolved value (from environment) or the original value if not a reference
+    """
+    if not value:
+        return value
+
+    match = _ENV_VAR_PATTERN.match(value.strip())
+    if match:
+        env_name = match.group(1)
+        env_value = os.environ.get(env_name)
+        if env_value:
+            return env_value
+        else:
+            logger.warning(f"Environment variable '{env_name}' not found, using literal value")
+            return None  # Env var not set, disable auth
+    return value
+
 
 def check_api_key(provided_key: Optional[str], expected_key: Optional[str]) -> bool:
     """Compare API keys using constant-time comparison to prevent timing attacks.
@@ -100,23 +130,29 @@ class AuthMiddleware:
 
         Args:
             api_key: The expected API key (None = no authentication)
+                     Supports ${ENV_VAR} syntax to reference environment variables
             enabled: Whether authentication is enabled
         """
-        self._api_key = api_key
+        self._api_key_raw = api_key  # Store original value (may be ${ENV_VAR})
         self._enabled = enabled and api_key is not None
 
     @property
     def enabled(self) -> bool:
         return self._enabled
 
+    @property
+    def _api_key(self) -> Optional[str]:
+        """Get the resolved API key (expands ${ENV_VAR} references)."""
+        return resolve_env_var(self._api_key_raw)
+
     def update_key(self, api_key: Optional[str], enabled: bool = True) -> None:
         """Update the API key configuration.
 
         Args:
-            api_key: New API key
+            api_key: New API key (supports ${ENV_VAR} syntax)
             enabled: Whether to enable authentication
         """
-        self._api_key = api_key
+        self._api_key_raw = api_key
         self._enabled = enabled and api_key is not None
 
     def authenticate(self, path: str, headers: dict) -> bool:
@@ -160,6 +196,7 @@ __all__ = [
     "check_api_key",
     "extract_api_key_from_headers",
     "is_path_exempt",
+    "resolve_env_var",
     "AuthMiddleware",
     "create_auth_check",
     "AUTH_EXEMPT_PATHS",

ida_pro_mcp/ida_mcp/framework.py

@@ -340,6 +340,7 @@ def get_functions_with_calls() -> list[str]:
     """
     import idaapi
     import idautils
+    import ida_idp
 
     result = []
     for func_ea in idautils.Functions():
@@ -352,7 +353,8 @@ def get_functions_with_calls() -> list[str]:
         for head in idautils.Heads(func.start_ea, func.end_ea):
             insn = idaapi.insn_t()
             if idaapi.decode_insn(insn, head) > 0:
-                if insn.itype in [idaapi.NN_call, idaapi.NN_callfi, idaapi.NN_callni]:
+                # Use architecture-independent call instruction detection
+                if ida_idp.is_call_insn(insn):
                     has_call = True
                     break
 

ida_pro_mcp/ida_mcp/server_manager.py

@@ -11,7 +11,7 @@ import threading
 from dataclasses import dataclass, field
 from typing import Optional, Callable, TYPE_CHECKING
 
-from .config import ServerInstanceConfig, McpConfig, get_config, save_config
+from .config import ServerInstanceConfig, McpConfig, get_config
 from .auth import AuthMiddleware
 from .port_utils import try_serve_with_port_retry
 

ida_pro_mcp/ida_mcp/sync.py

@@ -107,11 +107,14 @@ def _sync_wrapper(ff):
             raise IDASyncError(error_str)
 
         call_stack.put((ff.__name__))
+        # Enable batch mode for all synchronized operations
+        old_batch = idc.batch(1)
         try:
             res_container.put(ff())
         except Exception as x:
             res_container.put(x)
         finally:
+            idc.batch(old_batch)
             call_stack.get()
 
     idaapi.execute_sync(runned, idaapi.MFF_WRITE)
@@ -132,21 +135,14 @@ def _normalize_timeout(value: object) -> float | None:
 
 
 def sync_wrapper(ff, timeout_override: float | None = None):
-    """Wrapper to enable batch mode during IDA synchronization."""
+    """Wrapper to enable timeout and cancellation during IDA synchronization.
+
+    Note: Batch mode is handled in _sync_wrapper to ensure it's always
+    applied consistently for all synchronized operations.
+    """
     # Capture cancel event from thread-local before execute_sync
     cancel_event = get_current_cancel_event()
 
-    def _run_with_batch(inner_ff):
-        def _wrapped():
-            old_batch = idc.batch(1)
-            try:
-                return inner_ff()
-            finally:
-                idc.batch(old_batch)
-
-        _wrapped.__name__ = inner_ff.__name__
-        return _wrapped
-
     timeout = timeout_override
     if timeout is None:
         timeout = _get_tool_timeout_seconds()
@@ -172,8 +168,8 @@ def sync_wrapper(ff, timeout_override: float | None = None):
                 sys.setprofile(old_profile)
 
         timed_ff.__name__ = ff.__name__
-        return _sync_wrapper(_run_with_batch(timed_ff))
-    return _sync_wrapper(_run_with_batch(ff))
+        return _sync_wrapper(timed_ff)
+    return _sync_wrapper(ff)
 
 
 def idasync(f):

ida_pro_mcp/ida_mcp/tests/__init__.py

@@ -5,10 +5,10 @@ Tests are registered via the @test decorator from the framework module.
 """
 
 # Import all test modules to register tests when the package is imported
-from . import test_api_core
-from . import test_api_analysis
-from . import test_api_memory
-from . import test_api_modify
-from . import test_api_types
-from . import test_api_stack
-from . import test_api_resources
+from . import test_api_core as test_api_core
+from . import test_api_analysis as test_api_analysis
+from . import test_api_memory as test_api_memory
+from . import test_api_modify as test_api_modify
+from . import test_api_types as test_api_types
+from . import test_api_stack as test_api_stack
+from . import test_api_resources as test_api_resources

ida_pro_mcp/ida_mcp/tests/test_api_resources.py

@@ -145,7 +145,7 @@ def test_resource_struct_name():
 def test_resource_struct_name_not_found():
     """struct_name_resource handles non-existent structure"""
     try:
-        result = struct_name_resource("NonExistentStruct12345")
+        struct_name_resource("NonExistentStruct12345")
         # Should return error or empty
     except IDAError:
         pass  # Expected for non-existent struct

ida_pro_mcp/ida_mcp/ui.py

@@ -10,7 +10,6 @@ from typing import Optional, TYPE_CHECKING
 
 from .config import (
     ServerInstanceConfig,
-    McpConfig,
     get_config,
     save_config,
     reload_config,
@@ -34,9 +33,9 @@ class ServerConfigForm(idaapi.Form):
         instance_id = "" if is_new else config.instance_id
         host = "127.0.0.1" if is_new else config.host
         port = 13337 if is_new else config.port
-        auth_enabled = False if is_new else config.auth_enabled
+        _ = False if is_new else config.auth_enabled  # Reserved for future use
         api_key = "" if is_new else (config.api_key or "")
-        auto_start = False if is_new else config.auto_start
+        _ = False if is_new else config.auto_start  # Reserved for future use
 
         form_template = r"""STARTITEM 0
 BUTTON YES* Save

ida_pro_mcp/ida_mcp/utils.py

@@ -22,6 +22,7 @@ from typing import (
 
 import ida_funcs
 import ida_hexrays
+import ida_idp
 import ida_kernwin
 import ida_nalt
 import ida_typeinf
@@ -1022,7 +1023,8 @@ def get_callees(addr: str) -> list[dict]:
         while current_ea < func_end:
             insn = idaapi.insn_t()
             idaapi.decode_insn(insn, current_ea)
-            if insn.itype in [idaapi.NN_call, idaapi.NN_callfi, idaapi.NN_callni]:
+            # Use architecture-independent call instruction detection
+            if ida_idp.is_call_insn(insn):
                 target = idc.get_operand_value(current_ea, 0)
                 target_type = idc.get_operand_type(current_ea, 0)
                 if target_type in [idaapi.o_mem, idaapi.o_near, idaapi.o_far]:
@@ -1064,11 +1066,8 @@ def get_callers(addr: str, limit: int = 50) -> list[Function]:
                 continue
             insn = idaapi.insn_t()
             idaapi.decode_insn(insn, caller_addr)
-            if insn.itype not in [
-                idaapi.NN_call,
-                idaapi.NN_callfi,
-                idaapi.NN_callni,
-            ]:
+            # Use architecture-independent call instruction detection
+            if not ida_idp.is_call_insn(insn):
                 continue
             callers[func["addr"]] = func
 

ida_pro_mcp/ida_mcp.py

@@ -7,18 +7,32 @@ Features:
 - Web-based configuration at http://host:port/config.html
 - Bilingual interface (English/中文)
 - Server restart on config change
+- Auto port increment on conflict
 """
 
+import logging
 import sys
 import idaapi
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:
-    from . import ida_mcp
+    from .ida_mcp.zeromcp.mcp import McpServer
 
+# Configure logging to stdout (IDA console)
+logging.basicConfig(
+    level=logging.INFO,
+    format="[MCP] %(message)s",
+    handlers=[logging.StreamHandler(sys.stdout)],
+)
+logger = logging.getLogger(__name__)
 
-def unload_package(package_name: str):
-    """Remove every module that belongs to the package from sys.modules."""
+
+def unload_package(package_name: str) -> None:
+    """Remove every module that belongs to the package from sys.modules.
+
+    Args:
+        package_name: The package name to unload (e.g., 'ida_mcp')
+    """
     to_remove = [
         mod_name
         for mod_name in sys.modules
@@ -29,27 +43,47 @@ def unload_package(package_name: str):
 
 
 class MCP(idaapi.plugin_t):
+    """IDA Pro MCP Plugin for LLM-assisted reverse engineering.
+
+    Provides an MCP (Model Context Protocol) server that allows AI assistants
+    to interact with IDA Pro's disassembler and decompiler.
+
+    Attributes:
+        flags: Plugin flags for IDA
+        comment: Plugin description
+        help: Help text
+        wanted_name: Menu item name
+        wanted_hotkey: Keyboard shortcut (empty = none)
+    """
+
     flags = idaapi.PLUGIN_KEEP
     comment = "MCP Server for LLM-assisted reverse engineering"
     help = "Start/Stop MCP Server for AI assistants like Claude"
     wanted_name = "MCP Server"  # Menu name: Edit -> Plugins -> MCP Server
     wanted_hotkey = ""  # No hotkey
 
-    def init(self):
-        print("[MCP] Plugin loaded, use Edit -> Plugins -> MCP Server to toggle")
-        self.mcp = None
-        self._current_host = None
-        self._current_port = None
+    def init(self) -> int:
+        """Initialize the plugin when IDA loads it.
+
+        Returns:
+            PLUGIN_KEEP to keep the plugin loaded
+        """
+        logger.info("Plugin loaded, use Edit -> Plugins -> MCP Server to toggle")
+        self.mcp: McpServer | None = None
+        self._current_host: str | None = None
+        self._current_port: int | None = None
 
         # Auto-start server on IDA launch
         self._auto_start()
 
         return idaapi.PLUGIN_KEEP
 
-    def _auto_start(self):
-        """Auto-start server when IDA loads a database."""
-        # Use timer to delay startup until IDA is fully initialized
-        def delayed_start():
+    def _auto_start(self) -> None:
+        """Auto-start server when IDA loads a database.
+
+        Uses a timer to delay startup until IDA is fully initialized.
+        """
+        def delayed_start() -> int:
             if self.mcp is None:
                 self._start_server()
             return -1  # Don't repeat
@@ -57,8 +91,8 @@ class MCP(idaapi.plugin_t):
         # Delay 1 second to ensure IDA is ready
         idaapi.register_timer(1000, delayed_start)
 
-    def _start_server(self):
-        """Start the MCP server."""
+    def _start_server(self) -> None:
+        """Start the MCP server with automatic port retry on conflict."""
         if self.mcp:
             return  # Already running
 
@@ -76,7 +110,7 @@ class MCP(idaapi.plugin_t):
         try:
             init_caches()
         except Exception as e:
-            print(f"[MCP] Cache init failed: {e}")
+            logger.warning(f"Cache init failed: {e}")
 
         # Set restart callback for web config
         set_server_restart_callback(self._restart_server)
@@ -91,34 +125,38 @@ class MCP(idaapi.plugin_t):
                 MCP_SERVER, host, port, request_handler=IdaMcpHttpRequestHandler
             )
             if failed_ports:
-                print(f"[MCP] Port {port} was in use, auto-selected port {actual_port}")
+                logger.info(f"Port {port} was in use, auto-selected port {actual_port}")
             self._current_host = host
             self._current_port = actual_port
             self.mcp = MCP_SERVER
             set_download_base_url(f"http://{host}:{actual_port}")
-            print(f"[MCP] Server started on http://{host}:{actual_port}")
-            print(f"  Config: http://{host}:{actual_port}/config.html")
+            logger.info(f"Server started on http://{host}:{actual_port}")
+            logger.info(f"  Config: http://{host}:{actual_port}/config.html")
         except OSError as e:
             if e.errno in (48, 98, 10048):
-                print(format_port_exhausted_message(host, port, list(range(port, port + 10))))
+                logger.error(format_port_exhausted_message(host, port, list(range(port, port + 10))))
             else:
-                print(f"[MCP] Error starting server: {e}")
+                logger.error(f"Error starting server: {e}")
+
+    def _restart_server(self, new_host: str, new_port: int) -> None:
+        """Restart the server with new configuration.
 
-    def _restart_server(self, new_host: str, new_port: int):
-        """Callback to restart the server with new configuration.
+        This is called from a background thread, so we use execute_sync
+        to run the actual restart on IDA's main thread.
 
-        This is called from a background thread, so we need to use
-        execute_sync to run the actual restart on IDA's main thread.
+        Args:
+            new_host: New host address to bind
+            new_port: New port number to bind
         """
-        def do_restart():
-            print(f"[MCP] Restarting server on {new_host}:{new_port}...")
+        def do_restart() -> int:
+            logger.info(f"Restarting server on {new_host}:{new_port}...")
 
             # Stop current server
             if self.mcp:
                 try:
                     self.mcp.stop()
                 except Exception as e:
-                    print(f"[MCP] Error stopping server: {e}")
+                    logger.error(f"Error stopping server: {e}")
                 self.mcp = None
 
             # Reload package and start new server
@@ -136,7 +174,7 @@ class MCP(idaapi.plugin_t):
             try:
                 init_caches()
             except Exception as e:
-                print(f"[MCP] Cache init failed: {e}")
+                logger.warning(f"Cache init failed: {e}")
 
             # Set restart callback
             set_server_restart_callback(self._restart_server)
@@ -146,39 +184,49 @@ class MCP(idaapi.plugin_t):
                     MCP_SERVER, new_host, new_port, request_handler=IdaMcpHttpRequestHandler
                 )
                 if failed_ports:
-                    print(f"[MCP] Port {new_port} was in use, auto-selected port {actual_port}")
+                    logger.info(f"Port {new_port} was in use, auto-selected port {actual_port}")
                 self._current_host = new_host
                 self._current_port = actual_port
                 self.mcp = MCP_SERVER
                 set_download_base_url(f"http://{new_host}:{actual_port}")
-                print(f"[MCP] Server restarted on http://{new_host}:{actual_port}")
-                print(f"  Config: http://{new_host}:{actual_port}/config.html")
+                logger.info(f"Server restarted on http://{new_host}:{actual_port}")
+                logger.info(f"  Config: http://{new_host}:{actual_port}/config.html")
             except OSError as e:
                 if e.errno in (48, 98, 10048):
-                    print(format_port_exhausted_message(new_host, new_port, list(range(new_port, new_port + 10))))
+                    logger.error(format_port_exhausted_message(new_host, new_port, list(range(new_port, new_port + 10))))
                 else:
-                    print(f"[MCP] Error starting server: {e}")
+                    logger.error(f"Error starting server: {e}")
 
             return 1  # Required for execute_sync callback
 
         # Execute on IDA's main thread
         idaapi.execute_sync(do_restart, idaapi.MFF_WRITE)
 
-    def run(self, arg):
-        """Toggle server on/off via menu."""
+    def run(self, arg: int) -> None:
+        """Toggle server on/off via menu.
+
+        Args:
+            arg: Plugin argument (unused)
+        """
         if self.mcp:
             self.mcp.stop()
             self.mcp = None
-            print("[MCP] Server stopped")
+            logger.info("Server stopped")
         else:
             self._start_server()
 
-    def term(self):
+    def term(self) -> None:
+        """Cleanup when plugin is unloaded."""
         if self.mcp:
             self.mcp.stop()
 
 
-def PLUGIN_ENTRY():
+def PLUGIN_ENTRY() -> MCP:
+    """IDA plugin entry point.
+
+    Returns:
+        Plugin instance
+    """
     return MCP()
 
 

ida_pro_mcp_xjoker-1.0.2.dist-info/METADATA

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: ida-pro-mcp-xjoker
+Version: 1.0.2
+Summary: Vibe reversing with IDA Pro (enhanced fork)
+Author: mrexodia, can1357, IDA Pro MCP Contributors
+Maintainer: xjoker
+Project-URL: Repository, https://github.com/xjoker/ida-pro-mcp
+Project-URL: Issues, https://github.com/xjoker/ida-pro-mcp/issues
+Keywords: ida,mcp,llm,plugin
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: idapro>=0.0.7
+Requires-Dist: tomli-w>=1.0.0
+Dynamic: license-file
+
+# IDA Pro MCP (Enhanced Fork)
+
+[中文文档](https://github.com/xjoker/ida-pro-mcp/blob/main/README_zh.md) | English
+
+[![PyPI](https://img.shields.io/pypi/v/ida-pro-mcp-xjoker)](https://pypi.org/project/ida-pro-mcp-xjoker/)
+[![Python](https://img.shields.io/pypi/pyversions/ida-pro-mcp-xjoker)](https://pypi.org/project/ida-pro-mcp-xjoker/)
+
+An enhanced fork of [mrexodia/ida-pro-mcp](https://github.com/mrexodia/ida-pro-mcp) - MCP Server for LLM-assisted reverse engineering in IDA Pro.
+
+## What's Different from Original
+
+| Feature | Original | This Fork |
+|---------|----------|-----------|
+| **Multi-instance Support** | ❌ Port conflict crashes | ✅ Auto port increment (13337→13346) |
+| **Web Configuration** | ❌ None | ✅ Bilingual UI at `/config.html` |
+| **API Key Auth** | ❌ None | ✅ Bearer token + env var support |
+| **Server Startup** | Manual hotkey | ✅ Auto-start on IDA launch |
+| **Hotkey Conflicts** | Occupies Ctrl+Alt+M | ✅ No hotkey, menu-only |
+| **Config Persistence** | None | ✅ Saved per IDB database |
+
+### Key Enhancements
+
+- **Port Conflict Auto-Retry**: Multiple IDA instances automatically use different ports
+- **Web Config UI**: `http://localhost:13337/config.html` with English/中文 interface
+- **API Key Authentication**: Secure remote access with Bearer token
+- **Bug Fixes**: Thread safety, regex handling, type parsing errors fixed
+
+## Installation
+
+```bash
+pip install ida-pro-mcp-xjoker
+ida-pro-mcp --install
+```
+
+Restart IDA Pro completely after installation.
+
+## Quick Start
+
+1. Open a binary in IDA Pro
+2. MCP server starts automatically on `http://127.0.0.1:13337`
+3. Configure your MCP client:
+
+```bash
+# Claude Code
+claude mcp add ida-pro-mcp http://127.0.0.1:13337/mcp
+
+# With API Key authentication
+claude mcp add --transport http ida-pro-mcp http://127.0.0.1:13337/mcp \
+  --header "Authorization: Bearer your-api-key"
+```
+
+4. Open web config at `http://127.0.0.1:13337/config.html` to customize settings
+
+## Requirements
+
+- Python 3.11+
+- IDA Pro 8.3+ (9.0 recommended), **IDA Free not supported**
+- Any [MCP-compatible client](https://modelcontextprotocol.io/clients)
+
+## API Overview
+
+**71 MCP Tools** including:
+
+| Category | Tools |
+|----------|-------|
+| Analysis | `decompile`, `disasm`, `xrefs_to`, `callees`, `callers`, `basic_blocks` |
+| Memory | `get_bytes`, `get_string`, `get_int`, `patch` |
+| Types | `declare_type`, `set_type`, `infer_types`, `read_struct` |
+| Modify | `set_comments`, `rename`, `patch_asm` |
+| Search | `find_bytes`, `find_insns`, `find_regex` |
+| Debug | `dbg_*` (20+ debugger tools, enable with `?ext=dbg`) |
+| Python | `py_eval` - execute Python in IDA context |
+
+**24 MCP Resources** for read-only access:
+- `ida://idb/metadata`, `ida://cursor`, `ida://structs`, `ida://xrefs/from/{addr}`, etc.
+
+## Headless Mode
+
+```bash
+# SSE transport
+ida-pro-mcp --transport http://127.0.0.1:8744/sse
+
+# With idalib (no GUI)
+idalib-mcp --host 127.0.0.1 --port 8745 /path/to/binary
+```
+
+## Links
+
+- [Original Project](https://github.com/mrexodia/ida-pro-mcp) by mrexodia
+- [Changelog](https://github.com/xjoker/ida-pro-mcp/blob/main/CHANGELOG.md)
+- [Issues](https://github.com/xjoker/ida-pro-mcp/issues)
+
+## License
+
+MIT - Same as original project

{ida_pro_mcp_xjoker-1.0.1.dist-info → ida_pro_mcp_xjoker-1.0.2.dist-info}/RECORD

@@ -1,13 +1,13 @@
 ida_pro_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 ida_pro_mcp/__main__.py,sha256=OgGb-aPI4F2DJSaU1I-R-OpN_rZfs0hSnMgTo0CPg0o,124
-ida_pro_mcp/ida_mcp.py,sha256=-yUE4Ss8jVg1tKZjmXsWLhrQVJsFUpZ5Mc6KxOeOyyM,6982
+ida_pro_mcp/ida_mcp.py,sha256=fyvGl4JTQlnIt0Uwk8luAaud7ym6dd5zoguGwfArf8s,8381
 ida_pro_mcp/idalib_server.py,sha256=fuWVMjooZegKSl87Ldjg1zsRdDETyGLaSEy1rOoHfhY,11375
 ida_pro_mcp/idalib_session_manager.py,sha256=UEs0aZODEUOcWDiSRsUx8s9QfdJ-5p8PiTPpBitQUrc,8518
 ida_pro_mcp/server.py,sha256=AmpktGyT6yEZK03YoUkUHePshWslSoCpTwYRuGLhKoY,35849
 ida_pro_mcp/test.py,sha256=qqBnhhUkRYrL6cYdlGAMa6oN7wTvVrwzYLxzNez6jno,5023
 ida_pro_mcp/ida_mcp/__init__.py,sha256=92N8Ksbj7fDp5Z06M_bvdNw2BWaawmv-dyH52HBAxw0,1809
-ida_pro_mcp/ida_mcp/api_analysis.py,sha256=vx3hpLIpldALao3fyJYrjYVTR0rdFnG1IXg_XXLkjcw,42328
-ida_pro_mcp/ida_mcp/api_core.py,sha256=7j-98-8YTjrmQhtWCAFcR-f5h9g4GJM39DsRY7Il6mI,9291
+ida_pro_mcp/ida_mcp/api_analysis.py,sha256=LpZFbZq1FehuIkIru3TJTINNwOEiEedlYZUKOKIAbpQ,42377
+ida_pro_mcp/ida_mcp/api_core.py,sha256=gOsSI4WWvR0Od-wLAnjV5IVtl26Vcf9L_rkfv8ccQqA,9277
 ida_pro_mcp/ida_mcp/api_debug.py,sha256=WJKyizs06VQahFM4VWyoa6DXal-9f5JfkMj5Ji46UKw,16027
 ida_pro_mcp/ida_mcp/api_memory.py,sha256=HJ0Ut4jYQXKJJK9_h4ZL0yN-Mg1fCH9Blhn_gABoe8E,8968
 ida_pro_mcp/ida_mcp/api_modify.py,sha256=NEokHC_ZLvtYTtx1CSi0ZjSr9O75OlHzSWkEEwqTw_o,14390
@@ -15,31 +15,31 @@ ida_pro_mcp/ida_mcp/api_python.py,sha256=44PEMHNhJMdU4vK6yZ4CPAJbHkR5V-tNlDoTb2r
 ida_pro_mcp/ida_mcp/api_resources.py,sha256=3vhLHNvv3poT1vneNaAfXco7x8xJnS2a8BMS7F2CfG0,8559
 ida_pro_mcp/ida_mcp/api_stack.py,sha256=HfspQ9HnrjnWqWWIlwTT-aiti2FyKOUtD6zRCULo6Q0,5050
 ida_pro_mcp/ida_mcp/api_types.py,sha256=Dz5O0S8uDhrOf0eoOUtbd_BMzPRZqORrWwonWil0saM,16426
-ida_pro_mcp/ida_mcp/auth.py,sha256=ghpnbMAMOahvbpu33PDoxlyC_zQlU6iPR78HVGmyHXE,4553
+ida_pro_mcp/ida_mcp/auth.py,sha256=ANjMsCNPLkEW7kog9popq4K3Wo7wfD9B39mpVmvc_pg,5838
 ida_pro_mcp/ida_mcp/cache.py,sha256=t6DJEydv60dXAHkcCqdfAuD4a7kPrif9KZw3pLIle9Q,6837
 ida_pro_mcp/ida_mcp/config.py,sha256=WTLcKTo7Wi2Ll6uwzyWq7hPV8Sj9MnaQjtEnltAmmFk,6636
-ida_pro_mcp/ida_mcp/framework.py,sha256=k88c366JS4lQ7uIkVXPmlCMIWH7O9sr0Iw43aWJ9P5M,15976
+ida_pro_mcp/ida_mcp/framework.py,sha256=sIYyX9u1FdjOHTQU-fVei0bRUfVFxDctZqDQfJLVFtc,16029
 ida_pro_mcp/ida_mcp/http.py,sha256=PNFC31TCu19_WWUMJS2h-bY2Oxb1qh-fl5T0Bag0uis,27064
 ida_pro_mcp/ida_mcp/port_utils.py,sha256=zn3TNSdRsEzmsqOEnC4dOt8ZDUD85D1lXTVKOXzsbqs,3053
 ida_pro_mcp/ida_mcp/rpc.py,sha256=G0xRdmKehWq5JKlyE0gT7xmzdZ5YyfkEMH5cK9DNhrk,5079
-ida_pro_mcp/ida_mcp/server_manager.py,sha256=4hbTu_FmUNl_8oTcvoPUKKxpWaHYfew96rVl9sD2zk0,10835
-ida_pro_mcp/ida_mcp/sync.py,sha256=11EHzmALHwFIMo46tMtxpGyE0KIFyAf4WO49KjJPjzE,6823
-ida_pro_mcp/ida_mcp/ui.py,sha256=_L0vVPC-yyffBdtWNfndmSGkUNt6_83GhUPFYX-n41U,11204
-ida_pro_mcp/ida_mcp/utils.py,sha256=k2fkCtJAn9kQnfAaxcgxqtINHxiGTRDLbO3eN6oD_iA,34413
-ida_pro_mcp/ida_mcp/tests/__init__.py,sha256=-it_7Hb45krMiA5wTrylCA5vuOaTFoqY1Z4Y9jXAN7U,447
+ida_pro_mcp/ida_mcp/server_manager.py,sha256=VeW5Rn8I5qx9ukIml8kGkZQQKVHSNoyldTNUmIngfYU,10822
+ida_pro_mcp/ida_mcp/sync.py,sha256=55XKvBXxgZZO-mTUo0-bTvtAqTKjG-G81SdZgELbaEg,6787
+ida_pro_mcp/ida_mcp/ui.py,sha256=k4Mo2ztoPzjhq6LuUvzkFjheCWANeruVLtPKEiqVKCE,11223
+ida_pro_mcp/ida_mcp/utils.py,sha256=3uzcEgBtNMdO-v7b-W7G4JADibpBP3jU7I8FnP3GUXk,34425
+ida_pro_mcp/ida_mcp/tests/__init__.py,sha256=PzCMUTMRjb8xMM0H_WdwRPIlFJw5tXbE4G6Ehr1p7Ac,581
 ida_pro_mcp/ida_mcp/tests/test_api_analysis.py,sha256=5pe1qO8crvdYYuN7Tw8UEiH_FIc9pcC3rgRvSCqUqpc,8751
 ida_pro_mcp/ida_mcp/tests/test_api_core.py,sha256=uOh6C-UHIgrf_ZmK-lbmz5V_cXv5LsX0VDe7rgufMZM,7078
 ida_pro_mcp/ida_mcp/tests/test_api_memory.py,sha256=hNp986HaPISJK5GldRGYYk6KZj01in3SLOJ_YX981z0,5376
 ida_pro_mcp/ida_mcp/tests/test_api_modify.py,sha256=oV3XPzf_0E5_krDhCL7nyX7uW55ZEhYP3d5Yj4261c8,3403
-ida_pro_mcp/ida_mcp/tests/test_api_resources.py,sha256=ePkAuyrIhT6xHHP25lLZ2JlchEzHWMPMmiHFRBCyAt8,5749
+ida_pro_mcp/ida_mcp/tests/test_api_resources.py,sha256=busux61RA1s1bP5JbzGxkWtaj6NBFO7j-irZeIcSsuc,5740
 ida_pro_mcp/ida_mcp/tests/test_api_stack.py,sha256=8RHMQ0oNoVK5-i0Qo7_8iQ1HGok51g9H9STkRl0jgrs,2081
 ida_pro_mcp/ida_mcp/tests/test_api_types.py,sha256=LvXwfEc7P-ujWNO7LuNeVvNCbw6YJU-94xbEtpo94l0,7359
 ida_pro_mcp/ida_mcp/zeromcp/__init__.py,sha256=0wEXEn4fm9TtrM5saxTJ2ZORdvTRCQSXtN4GXBvhwCw,201
 ida_pro_mcp/ida_mcp/zeromcp/jsonrpc.py,sha256=U4klLVBp_mEh-lnRq5QWPkSxqtKc2J0C-i1hbxQgtIo,14836
 ida_pro_mcp/ida_mcp/zeromcp/mcp.py,sha256=7l4DT0ONcDOnSK78Mi5mKMF1_FOiVzj2TiOKvTTBy_k,31215
-ida_pro_mcp_xjoker-1.0.1.dist-info/licenses/LICENSE,sha256=7n59GIbEpWe6O3oNiKuqrFfnv-7kQCokhy7_p4ora24,1071
-ida_pro_mcp_xjoker-1.0.1.dist-info/METADATA,sha256=YDWlDVVax5I6DsrqIdattsvRO5UnPlwbgkRf-5wHTRw,17424
-ida_pro_mcp_xjoker-1.0.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-ida_pro_mcp_xjoker-1.0.1.dist-info/entry_points.txt,sha256=pJ_B_cB3hROec234fBV1ypw1kIz4edLRrk3OLOZbjug,137
-ida_pro_mcp_xjoker-1.0.1.dist-info/top_level.txt,sha256=EN_FyE128OksP65oLV_fL3VU618sjUD9yLSMaOES0Ug,12
-ida_pro_mcp_xjoker-1.0.1.dist-info/RECORD,,
+ida_pro_mcp_xjoker-1.0.2.dist-info/licenses/LICENSE,sha256=7n59GIbEpWe6O3oNiKuqrFfnv-7kQCokhy7_p4ora24,1071
+ida_pro_mcp_xjoker-1.0.2.dist-info/METADATA,sha256=xgx3nxPmBSpeTGprTUPsf_2NxBO6sJwinUgb9CEtLBM,4041
+ida_pro_mcp_xjoker-1.0.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ida_pro_mcp_xjoker-1.0.2.dist-info/entry_points.txt,sha256=pJ_B_cB3hROec234fBV1ypw1kIz4edLRrk3OLOZbjug,137
+ida_pro_mcp_xjoker-1.0.2.dist-info/top_level.txt,sha256=EN_FyE128OksP65oLV_fL3VU618sjUD9yLSMaOES0Ug,12
+ida_pro_mcp_xjoker-1.0.2.dist-info/RECORD,,

ida_pro_mcp_xjoker-1.0.1.dist-info/METADATA

@@ -1,405 +0,0 @@
-Metadata-Version: 2.4
-Name: ida-pro-mcp-xjoker
-Version: 1.0.1
-Summary: Vibe reversing with IDA Pro (enhanced fork)
-Author: mrexodia, can1357, IDA Pro MCP Contributors
-Project-URL: Repository, https://github.com/xjoker/ida-pro-mcp
-Project-URL: Issues, https://github.com/xjoker/ida-pro-mcp/issues
-Keywords: ida,mcp,llm,plugin
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: idapro>=0.0.7
-Requires-Dist: tomli-w>=1.0.0
-Dynamic: license-file
-
-# IDA Pro MCP
-
-[中文文档](README_zh.md) | English
-
-Simple [MCP Server](https://modelcontextprotocol.io/introduction) to allow vibe reversing in IDA Pro.
-
-## Fork Version Updates
-
-> This is a fork of [mrexodia/ida-pro-mcp](https://github.com/mrexodia/ida-pro-mcp) with the following enhancements:
-
-### New Features
-
-- **Web Configuration Interface** - Access `http://localhost:13337/config.html` for bilingual (English/中文) settings
-- **Server Configuration** - Configure host, port, and API Key authentication via web UI
-- **Auto-start on IDA Launch** - MCP server starts automatically when IDA loads a database
-- **No Keyboard Shortcut Occupation** - Removed all hotkey bindings, menu-only activation
-- **Menu Name Changed** - Plugin menu renamed from "MCP" to "MCP Server"
-- **Server Restart on Config Change** - Server automatically restarts after saving configuration
-
-### API Key Authentication
-
-To enable API Key authentication:
-
-1. Open the web configuration at `http://localhost:13337/config.html`
-2. Check "Enable API Key Authentication"
-3. Enter your API Key (or use `${ENV_VAR}` to reference an environment variable)
-4. Save and restart the server
-
-**Client Configuration Examples:**
-
-```bash
-# Claude Code - Add MCP server with Bearer token authentication
-claude mcp add --transport http ida-pro-mcp http://192.168.1.100:13337/mcp \
-  --header "Authorization: Bearer your-api-key-here"
-
-# Or configure in ~/.claude.json manually:
-{
-  "mcpServers": {
-    "ida-pro-mcp": {
-      "type": "http",
-      "url": "http://192.168.1.100:13337/mcp",
-      "headers": {
-        "Authorization": "Bearer your-api-key-here"
-      }
-    }
-  }
-}
-```
-
-### Bug Fixes
-
-- Fixed IDA main thread crash when restarting server
-- Fixed walrus operator logic error in type parsing
-- Added regex compilation exception handling
-- Fixed bare `except:` statements
-- Unified default pagination count values
-
----
-
-https://github.com/user-attachments/assets/6ebeaa92-a9db-43fa-b756-eececce2aca0
-
-The binaries and prompt for the video are available in the [mcp-reversing-dataset](https://github.com/mrexodia/mcp-reversing-dataset) repository.
-
-## Prerequisites
-
-- [Python](https://www.python.org/downloads/) (**3.11 or higher**)
-  - Use `idapyswitch` to switch to the newest Python version
-- [IDA Pro](https://hex-rays.com/ida-pro) (8.3 or higher, 9 recommended), **IDA Free is not supported**
-- Supported MCP Client (pick one you like)
-  - [Amazon Q Developer CLI](https://aws.amazon.com/q/developer/)
-  - [Augment Code](https://www.augmentcode.com/)
-  - [Claude](https://claude.ai/download)
-  - [Claude Code](https://www.anthropic.com/code)
-  - [Cline](https://cline.bot)
-  - [Codex](https://github.com/openai/codex)
-  - [Copilot CLI](https://docs.github.com/en/copilot)
-  - [Crush](https://github.com/charmbracelet/crush)
-  - [Cursor](https://cursor.com)
-  - [Gemini CLI](https://google-gemini.github.io/gemini-cli/)
-  - [Kilo Code](https://www.kilocode.com/)
-  - [Kiro](https://kiro.dev/)
-  - [LM Studio](https://lmstudio.ai/)
-  - [Opencode](https://opencode.ai/)
-  - [Qodo Gen](https://www.qodo.ai/)
-  - [Qwen Coder](https://qwenlm.github.io/qwen-code-docs/)
-  - [Roo Code](https://roocode.com)
-  - [Trae](https://trae.ai/)
-  - [VS Code](https://code.visualstudio.com/)
-  - [VS Code Insiders](https://code.visualstudio.com/insiders)
-  - [Warp](https://www.warp.dev/)
-  - [Windsurf](https://windsurf.com)
-  - [Zed](https://zed.dev/)
-  - [Other MCP Clients](https://modelcontextprotocol.io/clients#example-clients): Run `ida-pro-mcp --config` to get the JSON config for your client.
-
-## Installation
-
-Install the latest version of the IDA Pro MCP package:
-
-```sh
-pip uninstall ida-pro-mcp
-pip install https://github.com/xjoker/ida-pro-mcp/archive/refs/heads/main.zip
-```
-
-Configure the MCP servers and install the IDA Plugin:
-
-```
-ida-pro-mcp --install
-```
-
-**Important**: Make sure you completely restart IDA and your MCP client for the installation to take effect. Some clients (like Claude) run in the background and need to be quit from the tray icon.
-
-https://github.com/user-attachments/assets/65ed3373-a187-4dd5-a807-425dca1d8ee9
-
-_Note_: You need to load a binary in IDA before the plugin menu will show up.
-
-## Prompt Engineering
-
-LLMs are prone to hallucinations and you need to be specific with your prompting. For reverse engineering the conversion between integers and bytes are especially problematic. Below is a minimal example prompt, feel free to start a discussion or open an issue if you have good results with a different prompt:
-
-```md
-Your task is to analyze a crackme in IDA Pro. You can use the MCP tools to retrieve information. In general use the following strategy:
-
-- Inspect the decompilation and add comments with your findings
-- Rename variables to more sensible names
-- Change the variable and argument types if necessary (especially pointer and array types)
-- Change function names to be more descriptive
-- If more details are necessary, disassemble the function and add comments with your findings
-- NEVER convert number bases yourself. Use the `int_convert` MCP tool if needed!
-- Do not attempt brute forcing, derive any solutions purely from the disassembly and simple python scripts
-- Create a report.md with your findings and steps taken at the end
-- When you find a solution, prompt to user for feedback with the password you found
-```
-
-This prompt was just the first experiment, please share if you found ways to improve the output!
-
-Another prompt by [@can1357](https://github.com/can1357):
-
-```md
-Your task is to create a complete and comprehensive reverse engineering analysis. Reference AGENTS.md to understand the project goals and ensure the analysis serves our purposes.
-
-Use the following systematic methodology:
-
-1. **Decompilation Analysis**
-   - Thoroughly inspect the decompiler output
-   - Add detailed comments documenting your findings
-   - Focus on understanding the actual functionality and purpose of each component (do not rely on old, incorrect comments)
-
-2. **Improve Readability in the Database**
-   - Rename variables to sensible, descriptive names
-   - Correct variable and argument types where necessary (especially pointers and array types)
-   - Update function names to be descriptive of their actual purpose
-
-3. **Deep Dive When Needed**
-   - If more details are necessary, examine the disassembly and add comments with findings
-   - Document any low-level behaviors that aren't clear from the decompilation alone
-   - Use sub-agents to perform detailed analysis
-
-4. **Important Constraints**
-   - NEVER convert number bases yourself - use the int_convert MCP tool if needed
-   - Use MCP tools to retrieve information as necessary
-   - Derive all conclusions from actual analysis, not assumptions
-
-5. **Documentation**
-   - Produce comprehensive RE/*.md files with your findings
-   - Document the steps taken and methodology used
-   - When asked by the user, ensure accuracy over previous analysis file
-   - Organize findings in a way that serves the project goals outlined in AGENTS.md or CLAUDE.md
-```
-
-Live stream discussing prompting and showing some real-world malware analysis:
-
-[![](https://img.youtube.com/vi/iFxNuk3kxhk/0.jpg)](https://www.youtube.com/watch?v=iFxNuk3kxhk)
-
-## Tips for Enhancing LLM Accuracy
-
-Large Language Models (LLMs) are powerful tools, but they can sometimes struggle with complex mathematical calculations or exhibit "hallucinations" (making up facts). Make sure to tell the LLM to use the `int_convert` MCP tool and you might also need [math-mcp](https://github.com/EthanHenrickson/math-mcp) for certain operations.
-
-Another thing to keep in mind is that LLMs will not perform well on obfuscated code. Before trying to use an LLM to solve the problem, take a look around the binary and spend some time (automatically) removing the following things:
-
-- String encryption
-- Import hashing
-- Control flow flattening
-- Code encryption
-- Anti-decompilation tricks
-
-You should also use a tool like Lumina or FLIRT to try and resolve all the open source library code and the C++ STL, this will further improve the accuracy.
-
-## SSE Transport & Headless MCP
-
-You can run an SSE server to connect to the user interface like this:
-
-```sh
-uv run ida-pro-mcp --transport http://127.0.0.1:8744/sse
-```
-
-After installing [`idalib`](https://docs.hex-rays.com/user-guide/idalib) you can also run a headless SSE server:
-
-```sh
-uv run idalib-mcp --host 127.0.0.1 --port 8745 path/to/executable
-```
-
-_Note_: The `idalib` feature was contributed by [Willi Ballenthin](https://github.com/williballenthin).
-
-
-## MCP Resources
-
-**Resources** represent browsable state (read-only data) following MCP's philosophy.
-
-**Core IDB State:**
-- `ida://idb/metadata` - IDB file info (path, arch, base, size, hashes)
-- `ida://idb/segments` - Memory segments with permissions
-- `ida://idb/entrypoints` - Entry points (main, TLS callbacks, etc.)
-
-**UI State:**
-- `ida://cursor` - Current cursor position and function
-- `ida://selection` - Current selection range
-
-**Type Information:**
-- `ida://types` - All local types
-- `ida://structs` - All structures/unions
-- `ida://struct/{name}` - Structure definition with fields
-
-**Lookups:**
-- `ida://import/{name}` - Import details by name
-- `ida://export/{name}` - Export details by name
-- `ida://xrefs/from/{addr}` - Cross-references from address
-
-## Core Functions
-
-- `lookup_funcs(queries)`: Get function(s) by address or name (auto-detects, accepts list or comma-separated string).
-- `int_convert(inputs)`: Convert numbers to different formats (decimal, hex, bytes, ASCII, binary).
-- `list_funcs(queries)`: List functions (paginated, filtered).
-- `list_globals(queries)`: List global variables (paginated, filtered).
-- `imports(offset, count)`: List all imported symbols with module names (paginated).
-- `decompile(addr)`: Decompile function at the given address.
-- `disasm(addr)`: Disassemble function with full details (arguments, stack frame, etc).
-- `xrefs_to(addrs)`: Get all cross-references to address(es).
-- `xrefs_to_field(queries)`: Get cross-references to specific struct field(s).
-- `callees(addrs)`: Get functions called by function(s) at address(es).
-
-## Modification Operations
-
-- `set_comments(items)`: Set comments at address(es) in both disassembly and decompiler views.
-- `patch_asm(items)`: Patch assembly instructions at address(es).
-- `declare_type(decls)`: Declare C type(s) in the local type library.
-
-## Memory Reading Operations
-
-- `get_bytes(addrs)`: Read raw bytes at address(es).
-- `get_int(queries)`: Read integer values using ty (i8/u64/i16le/i16be/etc).
-- `get_string(addrs)`: Read null-terminated string(s).
-- `get_global_value(queries)`: Read global variable value(s) by address or name (auto-detects, compile-time values).
-
-## Stack Frame Operations
-
-- `stack_frame(addrs)`: Get stack frame variables for function(s).
-- `declare_stack(items)`: Create stack variable(s) at specified offset(s).
-- `delete_stack(items)`: Delete stack variable(s) by name.
-
-## Structure Operations
-
-- `read_struct(queries)`: Read structure field values at specific address(es).
-- `search_structs(filter)`: Search structures by name pattern.
-
-## Debugger Operations (Extension)
-
-Debugger tools are hidden by default. Enable with `?ext=dbg` query parameter:
-
-```
-http://127.0.0.1:13337/mcp?ext=dbg
-```
-
-**Control:**
-- `dbg_start()`: Start debugger process.
-- `dbg_exit()`: Exit debugger process.
-- `dbg_continue()`: Continue execution.
-- `dbg_run_to(addr)`: Run to address.
-- `dbg_step_into()`: Step into instruction.
-- `dbg_step_over()`: Step over instruction.
-
-**Breakpoints:**
-- `dbg_bps()`: List all breakpoints.
-- `dbg_add_bp(addrs)`: Add breakpoint(s).
-- `dbg_delete_bp(addrs)`: Delete breakpoint(s).
-- `dbg_toggle_bp(items)`: Enable/disable breakpoint(s).
-
-**Registers:**
-- `dbg_regs()`: All registers, current thread.
-- `dbg_regs_all()`: All registers, all threads.
-- `dbg_regs_remote(tids)`: All registers, specific thread(s).
-- `dbg_gpregs()`: GP registers, current thread.
-- `dbg_gpregs_remote(tids)`: GP registers, specific thread(s).
-- `dbg_regs_named(names)`: Named registers, current thread.
-- `dbg_regs_named_remote(tid, names)`: Named registers, specific thread.
-
-**Stack & Memory:**
-- `dbg_stacktrace()`: Call stack with module/symbol info.
-- `dbg_read(regions)`: Read memory from debugged process.
-- `dbg_write(regions)`: Write memory to debugged process.
-
-## Advanced Analysis Operations
-
-- `py_eval(code)`: Execute arbitrary Python code in IDA context (returns dict with result/stdout/stderr, supports Jupyter-style evaluation).
-- `analyze_funcs(addrs)`: Comprehensive function analysis (decompilation, assembly, xrefs, callees, callers, strings, constants, basic blocks).
-
-## Pattern Matching & Search
-
-- `find_regex(queries)`: Search strings with case-insensitive regex (paginated).
-- `find_bytes(patterns, limit=1000, offset=0)`: Find byte pattern(s) in binary (e.g., "48 8B ?? ??"). Max limit: 10000.
-- `find_insns(sequences, limit=1000, offset=0)`: Find instruction sequence(s) in code. Max limit: 10000.
-- `find(type, targets, limit=1000, offset=0)`: Advanced search (immediate values, strings, data/code references). Max limit: 10000.
-
-## Control Flow Analysis
-
-- `basic_blocks(addrs)`: Get basic blocks with successors and predecessors.
-
-## Type Operations
-
-- `set_type(edits)`: Apply type(s) to functions, globals, locals, or stack variables.
-- `infer_types(addrs)`: Infer types at address(es) using Hex-Rays or heuristics.
-
-## Export Operations
-
-- `export_funcs(addrs, format)`: Export function(s) in specified format (json, c_header, or prototypes).
-
-## Graph Operations
-
-- `callgraph(roots, max_depth)`: Build call graph from root function(s) with configurable depth.
-
-## Batch Operations
-
-- `rename(batch)`: Unified batch rename operation for functions, globals, locals, and stack variables (accepts dict with optional `func`, `data`, `local`, `stack` keys).
-- `patch(patches)`: Patch multiple byte sequences at once.
-- `put_int(items)`: Write integer values using ty (i8/u64/i16le/i16be/etc).
-
-**Key Features:**
-
-- **Type-safe API**: All functions use strongly-typed parameters with TypedDict schemas for better IDE support and LLM structured outputs
-- **Batch-first design**: Most operations accept both single items and lists
-- **Consistent error handling**: All batch operations return `[{..., error: null|string}, ...]`
-- **Cursor-based pagination**: Search functions return `cursor: {next: offset}` or `{done: true}` (default limit: 1000, enforced max: 10000 to prevent token overflow)
-- **Performance**: Strings are cached with MD5-based invalidation to avoid repeated `build_strlist` calls in large projects
-
-## Comparison with other MCP servers
-
-There are a few IDA Pro MCP servers floating around, but I created my own for a few reasons:
-
-1. Installation should be fully automated.
-2. The architecture of other plugins make it difficult to add new functionality quickly (too much boilerplate of unnecessary dependencies).
-3. Learning new technologies is fun!
-
-If you want to check them out, here is a list (in the order I discovered them):
-
-- https://github.com/taida957789/ida-mcp-server-plugin (SSE protocol only, requires installing dependencies in IDAPython).
-- https://github.com/fdrechsler/mcp-server-idapro (MCP Server in TypeScript, excessive boilerplate required to add new functionality).
-- https://github.com/MxIris-Reverse-Engineering/ida-mcp-server (custom socket protocol, boilerplate).
-
-Feel free to open a PR to add your IDA Pro MCP server here.
-
-## Development
-
-Adding new features is a super easy and streamlined process. All you have to do is add a new `@tool` function to the modular API files in `src/ida_pro_mcp/ida_mcp/api_*.py` and your function will be available in the MCP server without any additional boilerplate! Below is a video where I add the `get_metadata` function in less than 2 minutes (including testing):
-
-https://github.com/user-attachments/assets/951de823-88ea-4235-adcb-9257e316ae64
-
-To test the MCP server itself:
-
-```sh
-npx -y @modelcontextprotocol/inspector
-```
-
-This will open a web interface at http://localhost:5173 and allow you to interact with the MCP tools for testing.
-
-For testing I create a symbolic link to the IDA plugin and then POST a JSON-RPC request directly to `http://localhost:13337/mcp`. After [enabling symbolic links](https://learn.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development) you can run the following command:
-
-```sh
-uv run ida-pro-mcp --install
-```
-
-Generate the changelog of direct commits to `main`:
-
-```sh
-git log --first-parent --no-merges 1.2.0..main "--pretty=- %s"
-```