@i-scope/mcp-server 0.4.3 → 0.4.4

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this package will be documented here. The format
 is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
 this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [0.4.4] — 2026-09-02
+
+### Changed
+
+- README Quick start: Cursor / VS Code users run **iScope: Enable MCP**
+  in the Marketplace extension (0.1.6+). Manual `mcp.json` remains for
+  other MCP clients. Reload is `Developer: Reload Window` in the editor,
+  not Oscilloscope.
+
 ## [0.4.3] — 2026-09-02
 
 ### Changed

package/README.md

@@ -11,8 +11,10 @@
 > Debugger SDK (DAP adapter, native helper, source-map / VLST / COM
 > leaves). Install `@i-scope/mcp-server` **directly** only when you want
 > the MCP server surface without the rest of the SDK on your top-level
-> `package.json` (e.g. an MCP-only Cursor / Claude Code config via
-> `npx -y @i-scope/mcp-server`).
+> `package.json` (e.g. an MCP-only Claude Code config via
+> `npx -y @i-scope/mcp-server`). Cursor / VS Code end-users should
+> install the **iScope .ajs Debugger** extension from Marketplace and
+> run **iScope: Enable MCP** instead of editing `mcp.json` by hand.
 
 Model Context Protocol (MCP) server that lets AI agents drive a
 `Oscilloscope.exe` debug session for `.ajs` scripts — set breakpoints,
@@ -37,11 +39,20 @@ through standard MCP tools layered on top of the iScope DAP adapter.
 
 2. **Install** the MCP server. Two flavours:
 
-   **End-user (npm-only)** — no repo clone, no local build:
+   **Cursor / VS Code (recommended)** — install
+   [iScope .ajs Debugger](https://marketplace.visualstudio.com/items?itemName=i-scope.iscope-debugger)
+   (`cursor --install-extension i-scope.iscope-debugger` or the same
+   with `code`). Command Palette → **iScope: Enable MCP** → confirm.
+   That merges `npx -y @i-scope/mcp-server` into workspace
+   `.cursor/mcp.json` (Cursor) or `.vscode/mcp.json` (VS Code) and
+   leaves other servers alone. Then **Developer: Reload Window** in
+   **this editor** (not Oscilloscope).
+
+   **Other MCP clients / no extension** — no repo clone:
 
    ```pwsh
    npm install -g @i-scope/mcp-server
-   # ...or use npx in mcp.json (see step 3).
+   # ...or use npx in the client's mcp.json (see step 3).
    ```
 
    This pulls in `@i-scope/dap-adapter`, `@i-scope/iscope-bridge-client`,
@@ -57,7 +68,9 @@ through standard MCP tools layered on top of the iScope DAP adapter.
    npm --workspace=@i-scope/iscope-bridge run build:msbuild
    ```
 
-3. **Configure your MCP client** (Cursor example, `.cursor/mcp.json`):
+3. **Configure your MCP client** only if you skipped **iScope: Enable MCP**.
+
+   Cursor (`.cursor/mcp.json`):
 
    ```json
    {
@@ -70,6 +83,20 @@ through standard MCP tools layered on top of the iScope DAP adapter.
    }
    ```
 
+   VS Code (`.vscode/mcp.json`):
+
+   ```json
+   {
+     "servers": {
+       "iscope-debug": {
+         "type": "stdio",
+         "command": "npx",
+         "args": ["-y", "@i-scope/mcp-server"]
+       }
+     }
+   }
+   ```
+
    For local development from the monorepo:
 
    ```json
@@ -86,7 +113,8 @@ through standard MCP tools layered on top of the iScope DAP adapter.
    `ISCOPE_EXTENSION_PATH` is optional now — set it only when you want
    to override the helper-binary lookup with a custom bundled root.
 
-3. **Reload Cursor** and ask your AI agent:
+4. **Reload this editor** (Command Palette → `Developer: Reload Window`
+   in Cursor or VS Code — not Oscilloscope) and ask your AI agent:
 
    > "Run `dist/Analyzer.ajs` and pause on `src/index.ts:42`, show me
    > the value of `signal` at that point."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i-scope/mcp-server",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "license": "MIT",
   "description": "Model Context Protocol server for iScope / Oscilloscope.exe debug & control. Lets AI agents drive a .ajs debug session — breakpoints, step, variables, evaluate — through standard MCP tools layered on top of the iScope DAP adapter.",
   "keywords": [