You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: mcp_nexus_web/crash-analyze-command.md
+2-48Lines changed: 2 additions & 48 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,62 +18,16 @@ Analyze the crash dump file specified by `[filename]` to determine the root caus
18
18
19
19
***
20
20
21
-
### **USAGE GUIDE**
22
-
23
-
#### MCP Tools 🛠️
24
-
25
-
Core debugging tools for **crash dump analysis**.
26
-
27
-
***TOOLS**: Use `tools/call` method to execute debugging operations (**open session**, **run commands**, **close session**).
28
-
***RESOURCES**: Use `resources/read` method to access data (**command lists**, **session lists**, **documentation**, **metrics**).
29
-
* After opening an analyze session, **WinDBG commands** can be asynchronously executed.
30
-
* Command results can be accessed via the **'nexus_read_dump_analyze_command_result' tool** or **'List Commands' resource**.
31
-
* Opening a session without executing commands will not have any effect.
32
-
33
-
##### Available Tools
34
-
35
-
| Step Title | Tool Name | Action | Input | Output | Note |
36
-
| :--- | :--- | :--- | :--- | :--- | :--- |
37
-
|**Tooling - Open Session**|`nexus_open_dump_analyze_session`| Open the analyze session for the dump file with the tool from Nexus MCP server. |`dumpPath` (string, required), `symbolsPath` (string, optional) |`sessionid`| This **EXACT sessionid IS REQUIRED TO BE USED** for all following commands in the session. |
38
-
|**Tooling - Exec Command**|`nexus_enqueue_async_dump_analyze_command`| Use the tool to start asynchronous execution of the WinDBG commands. |`command` (string, required), `sessionId` (string, required) |`commandId`| This **EXACT commandId IS REQUIRED TO BE USED** for the 'nexus_read_dump_analyze_command_result' tool to get the asynchronous result. |
39
-
|**Tooling - Close Session**|`nexus_close_dump_analyze_session`| Use the tool to close the analyze session of the dump file after all commands are executed or the session is not needed anymore. |`sessionId` (string, required) |*(null)*|*(null)*|
40
-
|**Tooling - Get Command Result**|`nexus_read_dump_analyze_command_result`| Get status and results of a specific async command that was previously queued. |`sessionId` (string, required), `commandId` (string, required) |`command result and status`| Use this tool to retrieve results from commands executed with nexus_enqueue_async_dump_analyze_command |
41
-
|**Extensions - Execute**|`nexus_enqueue_async_extension_command`| Execute an extension workflow (e.g., `stack_with_sources`) that orchestrates multiple WinDBG commands. |`sessionId` (string, required), `extensionName` (string, required), `parameters` (object, optional) |`commandId` (prefixed with `ext-`) | Poll results with `nexus_read_dump_analyze_command_result`|
42
-
43
-
---
44
-
45
-
#### MCP Resources 📚
46
-
47
-
Access data and results using the **`resources/read` method** (**NOT `tools/call`**).
48
-
49
-
* Use the `resources/read` method to access these resources.
50
-
***Resources** provide data access; **tools** provide action execution.
51
-
52
-
##### Available Resources
53
-
54
-
| URI | Name | Description | Input | Note/Usage |
55
-
| :--- | :--- | :--- | :--- | :--- |
56
-
|`workflows`|**Crash Analysis Workflows**| Comprehensive step-by-step analysis workflows for Windows crash dump investigation. |*(null)*| Access via `MCP resources/read` method. |
57
-
|`usage`|**Usage**| Essential tool usage information for MCP Nexus server. |*(null)*| Access via `MCP resources/read` method. |
58
-
|`sessions`|**List Sessions**| List all debugging sessions with status and activity information. |*(null)*| Use: `sessions` resource (no parameters - returns all sessions). |
59
-
|`commands`|**List Commands**| List async commands from all sessions with status and timing information. |*(null)*| Use: `commands` resource (no parameters - returns all commands). |
60
-
|`metrics`|**Performance Metrics**| Get comprehensive performance metrics and statistics. |*(null)*| Use: `metrics` resource (no parameters - returns performance data). |
61
-
|`circuits`|**Circuit Breaker Status**| Get circuit breaker status and health information. |*(null)*| Use: `circuits` resource (no parameters - returns circuit status). |
62
-
|`health`|**System Health**| Get comprehensive system health status. |*(null)*| Use: `health` resource (no parameters - returns health status). |
63
-
|`cache`|**Cache Statistics**| Get cache statistics and memory usage information. |*(null)*| Use: `cache` resource (no parameters - returns cache stats). |
64
-
65
-
***
66
-
67
21
### 🔧 **REQUIRED ACTIONS & WORKFLOW**
68
22
69
23
The following steps must be performed sequentially. Ensure all mandatory rules are followed at each stage.
70
24
71
25
1.**Initialize Analysis:** Open the analyze session for the dump file with the tool from Nexus MCP server `nexus_open_dump_analyze_session`. Feel free to run multiple sessions in parallel if it helps to make the **analysis** faster, the system **resources** allow that and the commands are independent
72
26
2.**Source Code Retrieval:**
73
-
* Enable the source server: `.srcfix+`
74
27
* Enable source verbosity: `.srcnoisy 3`
75
28
* Ensure the folder exists `[workingdir]\source`
76
-
* Set the source server path: `.srcpath "srv*[workingdir]\source"`
29
+
* Set the source server path: `!home "[workingdir]\source"`
30
+
* Enable the source server: `.srcfix+`
77
31
* Execute the extension to resolve sources for the current stack and frames.
78
32
* Use tool: `nexus_enqueue_async_extension_command` with `sessionId` and `extensionName = "stack_with_sources"`.
79
33
* The tool returns a `commandId` (prefixed with `ext-`)
0 commit comments