Modernized MCP architecture. Consolidated tool namespace, added resources and prompts.

Author: jtang613

README.md

@@ -5,6 +5,21 @@
 Binary Ninja requires this __init__.py file in the root directory to recognize the plugin.
 """
 
+# Fix pywin32 paths on Windows (required for mcp library)
+# Binary Ninja doesn't process .pth files, so we add the paths manually
+import sys
+import os
+if sys.platform == 'win32':
+    _site_packages = os.path.join(os.environ.get('APPDATA', ''), 'Binary Ninja', 'python310', 'site-packages')
+    _win32_paths = [
+        os.path.join(_site_packages, 'win32'),
+        os.path.join(_site_packages, 'win32', 'lib'),
+        os.path.join(_site_packages, 'Pythonwin'),
+    ]
+    for _p in _win32_paths:
+        if _p not in sys.path and os.path.isdir(_p):
+            sys.path.insert(0, _p)
+
 import logging
 
 # Configure logging early
@@ -56,7 +71,7 @@ def on_binaryview_analysis_completion(bv):
     except ImportError as import_err:
         logger.error(f"Failed to import BinAssistMCP modules: {import_err}")
         bn.log_error(f"BinAssistMCP plugin failed to load - missing dependencies: {import_err}")
-        bn.log_info("To fix this, install BinAssistMCP dependencies: pip install anyio hypercorn mcp trio pydantic pydantic-settings click")
+        bn.log_info("To fix this, install BinAssistMCP dependencies: pip install anyio hypercorn mcp pydantic pydantic-settings click")
 
     except Exception as plugin_err:
         logger.error(f"Failed to initialize BinAssistMCP plugin: {plugin_err}")

__init__.py

@@ -0,0 +1,138 @@
+# BinAssist on Windows - Installation Guide
+
+This guide covers the steps required to get BinAssist and BinAssistMCP plugins working on Windows with Binary Ninja.
+
+## Prerequisites
+
+- Binary Ninja installed (typically at `C:\Program Files\Vector35\BinaryNinja\`)
+- Plugins cloned to `%APPDATA%\Binary Ninja\plugins\`
+  - `BinAssist\`
+  - `BinAssistMCP\`
+
+## The Problem
+
+Binary Ninja on Windows uses a bundled Python environment, but:
+1. It doesn't fully process `.pth` files during site initialization
+2. The `mcp` library requires `pywin32`, which needs special DLL handling on Windows
+3. Packages must be installed to Binary Ninja's user site-packages, not the system Python
+
+## Step 1: Configure Binary Ninja Python Environment
+
+In Binary Ninja, go to **Settings → Python** and configure:
+- **Python Environment**: `C:\Program Files\Vector35\BinaryNinja\plugins\python\python310.dll`
+- **Site-packages**: `C:/Users/<username>/AppData/Roaming/Binary Ninja/python310/site-packages`
+
+This ensures packages are installed to a user-writable location.
+
+## Step 2: Install pywin32 DLLs (Administrator Required)
+
+The `pywin32` package includes DLLs that must be accessible at runtime. Copy them to the Binary Ninja installation folder.
+
+Open **Command Prompt as Administrator** and run:
+
+```cmd
+copy "C:\Users\<username>\AppData\Roaming\Binary Ninja\python310\site-packages\pywin32_system32\*.dll" "C:\Program Files\Vector35\BinaryNinja\"
+```
+
+Or if pywin32 is in the Program Files site-packages:
+
+```cmd
+copy "C:\Program Files\Vector35\BinaryNinja\plugins\python\Lib\site-packages\pywin32_system32\*.dll" "C:\Program Files\Vector35\BinaryNinja\"
+```
+
+This copies `pythoncom310.dll` and `pywintypes310.dll` to a location on the DLL search path.
+
+## Step 3: Install Plugin Dependencies
+
+Install all required packages to Binary Ninja's user site-packages using `--target`:
+
+**Install pywin32:**
+```cmd
+"C:\Program Files\Vector35\BinaryNinja\plugins\python\python.exe" -m pip install --target "C:\Users\<username>\AppData\Roaming\Binary Ninja\python310\site-packages" pywin32
+```
+
+**Install BinAssist dependencies:**
+```cmd
+"C:\Program Files\Vector35\BinaryNinja\plugins\python\python.exe" -m pip install --target "C:\Users\<username>\AppData\Roaming\Binary Ninja\python310\site-packages" -r "C:\Users\<username>\AppData\Roaming\Binary Ninja\plugins\BinAssist\requirements.txt"
+```
+
+**Install BinAssistMCP dependencies:**
+```cmd
+"C:\Program Files\Vector35\BinaryNinja\plugins\python\python.exe" -m pip install --target "C:\Users\<username>\AppData\Roaming\Binary Ninja\python310\site-packages" -r "C:\Users\<username>\AppData\Roaming\Binary Ninja\plugins\BinAssistMCP\requirements.txt"
+```
+
+> **Note:** Replace `<username>` with your actual Windows username, or use `%APPDATA%` in the path (though `--target` may not expand environment variables).
+
+## Step 4: Restart Binary Ninja
+
+Close all Binary Ninja instances and restart. The plugins should now load correctly.
+
+## Verification
+
+In Binary Ninja's Python console, verify the imports work:
+
+```python
+import pywintypes
+print("pywintypes OK")
+
+import mcp
+print("mcp OK")
+```
+
+## Notes: pywin32 Path Fix (Already Applied - For Reference Only)
+
+Binary Ninja doesn't process `.pth` files, so the `win32` and `win32\lib` directories aren't automatically added to `sys.path`. 
+
+Both plugins include a fix in their `__init__.py` that adds these paths before importing the `mcp` library:
+
+```python
+# Fix pywin32 paths on Windows (required for mcp library)
+# Binary Ninja doesn't process .pth files, so we add the paths manually
+import sys
+import os
+if sys.platform == 'win32':
+    _site_packages = os.path.join(os.environ.get('APPDATA', ''), 'Binary Ninja', 'python310', 'site-packages')
+    _win32_paths = [
+        os.path.join(_site_packages, 'win32'),
+        os.path.join(_site_packages, 'win32', 'lib'),
+        os.path.join(_site_packages, 'Pythonwin'),
+    ]
+    for _p in _win32_paths:
+        if _p not in sys.path and os.path.isdir(_p):
+            sys.path.insert(0, _p)
+```
+
+This code is already included in the plugin source.
+
+
+## Troubleshooting
+
+### "ModuleNotFoundError: No module named 'pywintypes'"
+
+- Ensure the DLLs were copied to `C:\Program Files\Vector35\BinaryNinja\`
+- Verify the path fix is in `__init__.py` and runs before any mcp imports
+- Check that `win32\lib\pywintypes.py` exists in your site-packages
+
+### "Access is denied" when installing packages
+
+- Use the `--target` flag to install to the roaming site-packages
+- Or run the command prompt as Administrator
+
+### Packages installing to wrong location
+
+- Always use the full path to Binary Ninja's Python:
+  ```
+  "C:\Program Files\Vector35\BinaryNinja\plugins\python\python.exe"
+  ```
+- Use `--target` to explicitly specify the destination
+
+### Check sys.path
+
+In Binary Ninja's Python console:
+
+```python
+import sys
+print('\n'.join(sys.path))
+```
+
+Ensure your roaming site-packages and the win32 subdirectories are listed.

binassistmcp-on-windows.md

@@ -13,7 +13,7 @@
     "description": "Comprehensive MCP server for Binary Ninja with SSE transport support",
     "license": {
         "name": "MIT",
-        "text": "Copyright (c) 2025\n\nPermission 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:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE 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."
+        "text": "Copyright (c) 2026\n\nPermission 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:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE 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."
     },
     "platforms": [
         "Darwin",
@@ -25,15 +25,14 @@
         "Linux": "Install via Binary Ninja plugin manager or copy to ~/.binaryninja/plugins/", 
         "Windows": "Install via Binary Ninja plugin manager or copy to %APPDATA%\\Binary Ninja\\plugins\\"
     },
-    "version": "1.1.0",
+    "version": "2.0.0",
     "minimumbinaryninjaversion": 5000,
     "dependencies": {
         "pip": [
             "anyio>=4.6.0",
             "hypercorn>=0.17.0",
-            "mcp>=1.23.3", 
+            "mcp>=1.23.3",
             "click>=8.0.0",
-            "trio>=0.27.0",
             "pydantic>=2.0.0",
             "pydantic-settings>=2.0.0"
         ]