Skip to content

Commit 7a4f552

Browse files
authored
Update MCP description (#5)
* Update description so LLMs will know better when to use MCP * Update package.json
1 parent fd777ac commit 7a4f552

File tree

3 files changed

+33
-29
lines changed

3 files changed

+33
-29
lines changed

package-lock.json

Lines changed: 8 additions & 4 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"name": "mcp-nodejs-debugger",
3-
"version": "0.1.0-beta.5",
2+
"name": "@hyperdrive-eng/mcp-nodejs-debugger",
3+
"version": "0.2.0",
44
"description": "An MCP server to debug Node.js at runtime",
55
"main": "index.js",
66
"bin": "./index.js",
@@ -37,10 +37,10 @@
3737
},
3838
"repository": {
3939
"type": "git",
40-
"url": "https://github.com/hyperdrive-eng/mcp-debugger"
40+
"url": "https://github.com/hyperdrive-eng/mcp-nodejs-debugger"
4141
},
4242
"bugs": {
43-
"url": "https://github.com/hyperdrive-eng/mcp-debugger/issues"
43+
"url": "https://github.com/hyperdrive-eng/mcp-nodejs-debugger/issues"
4444
},
4545
"homepage": "https://hyperdrive.engineering"
4646
}

src/mcp-server.js

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -6,27 +6,27 @@ import fetch from 'node-fetch';
66

77
// Create an MCP server
88
const server = new McpServer({
9-
name: "Inspector",
10-
version: "1.0.0",
11-
description: `Node.js debugger that allows setting breakpoints and inspecting variables.
12-
When using debugging capabilities, always instruct the user to navigate to their
13-
website after setting breakpoints. Breakpoints will only be triggered when the user
14-
interacts with their website in a way that causes the code at the breakpoint location to execute.
15-
When user requests debugging, always use the following format:
16-
1. Set breakpoint
17-
2. Wait for user to navigate to their website and trigger breakpoint
18-
3. Inspect variables
19-
4. Execute code
20-
5. Step over
21-
6. Step into
22-
7. Step out
23-
8. Continue execution
24-
9. Delete breakpoint
25-
10. List breakpoints
26-
11. Get current location
27-
12. Evaluate expression
28-
13. Get script source
29-
14. Get properties`
9+
name: "NodeJS Debugger",
10+
version: "0.2.0",
11+
description: `Advanced Node.js debugger for runtime analysis and troubleshooting. This tool connects to Node.js's built-in Inspector Protocol to provide powerful debugging capabilities directly through Claude Code.
12+
13+
DEBUGGING STRATEGY:
14+
Use debugger for the following:
15+
- When you need to understand the runtime state of the application
16+
- When you need to test potential fixes for the application
17+
- When you need to explore the codebase to find the root cause of an issue
18+
19+
20+
IMPORTANT NOTES:
21+
- ALWAYS assume the user has already started their Node.js application in debug mode.
22+
- If connection issues occur, suggest using retry_connect tool instead of restarting the server
23+
- Don't try to start the debugger or the node server yourself.
24+
- Always ask the user to trigger breakpoints manually, give them specific instructions on how to do so.
25+
- When user interaction is required, provide EXTREMELY specific instructions
26+
- Take initiative to explore the runtime state thoroughly when breakpoint is hit
27+
- Keep breakpoints active until issue is fully resolved, then clean up using delete_breakpoint
28+
- Set multiple strategic breakpoints at once to capture the full execution path leading to an error.
29+
- NEVER use fetch() as it will break the debugging connection.`
3030
});
3131

3232
class Inspector {

0 commit comments

Comments
 (0)