Skip to content

Commit 05afdbb

Browse files
Add the home dir command to the preprocessor
1 parent 0878e31 commit 05afdbb

File tree

1 file changed

+2
-48
lines changed

1 file changed

+2
-48
lines changed

mcp_nexus_web/crash-analyze-command.md

Lines changed: 2 additions & 48 deletions
Original file line numberDiff line numberDiff line change
@@ -18,62 +18,16 @@ Analyze the crash dump file specified by `[filename]` to determine the root caus
1818

1919
***
2020

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-
6721
### 🔧 **REQUIRED ACTIONS & WORKFLOW**
6822

6923
The following steps must be performed sequentially. Ensure all mandatory rules are followed at each stage.
7024

7125
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
7226
2. **Source Code Retrieval:**
73-
* Enable the source server: `.srcfix+`
7427
* Enable source verbosity: `.srcnoisy 3`
7528
* 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+`
7731
* Execute the extension to resolve sources for the current stack and frames.
7832
* Use tool: `nexus_enqueue_async_extension_command` with `sessionId` and `extensionName = "stack_with_sources"`.
7933
* The tool returns a `commandId` (prefixed with `ext-`)

0 commit comments

Comments
 (0)