debugger-mcp-server 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/publish-npm.yml +46 -0
- package/README.md +2 -50
- package/package.json +1 -1
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
name: Publish to npm
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches:
|
|
6
|
+
- main
|
|
7
|
+
|
|
8
|
+
jobs:
|
|
9
|
+
publish:
|
|
10
|
+
runs-on: ubuntu-latest
|
|
11
|
+
permissions:
|
|
12
|
+
contents: write
|
|
13
|
+
steps:
|
|
14
|
+
- name: Checkout
|
|
15
|
+
uses: actions/checkout@v4
|
|
16
|
+
with:
|
|
17
|
+
fetch-depth: 0
|
|
18
|
+
token: ${{ secrets.GITHUB_TOKEN }}
|
|
19
|
+
|
|
20
|
+
- name: Setup Node.js
|
|
21
|
+
uses: actions/setup-node@v4
|
|
22
|
+
with:
|
|
23
|
+
node-version: "20"
|
|
24
|
+
registry-url: "https://registry.npmjs.org"
|
|
25
|
+
|
|
26
|
+
- name: Configure Git
|
|
27
|
+
run: |
|
|
28
|
+
git config user.name "github-actions[bot]"
|
|
29
|
+
git config user.email "github-actions[bot]@users.noreply.github.com"
|
|
30
|
+
|
|
31
|
+
- name: Install dependencies
|
|
32
|
+
run: npm ci
|
|
33
|
+
|
|
34
|
+
- name: Build
|
|
35
|
+
run: npm run build
|
|
36
|
+
|
|
37
|
+
- name: Bump version
|
|
38
|
+
run: 'npm version patch --message "chore: bump version [skip ci]"'
|
|
39
|
+
|
|
40
|
+
- name: Push version bump
|
|
41
|
+
run: git push --follow-tags
|
|
42
|
+
|
|
43
|
+
- name: Publish to npm
|
|
44
|
+
run: npm publish
|
|
45
|
+
env:
|
|
46
|
+
NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
|
package/README.md
CHANGED
|
@@ -11,66 +11,24 @@ AI Agent <--> MCP Server (:6090) <--> VS Code Extension Bridge (:7070) <-->
|
|
|
11
11
|
|
|
12
12
|
The two components communicate over HTTP. The extension writes its port to `~/.agentic-debugger/bridge-port`, which the MCP server reads to discover the bridge automatically.
|
|
13
13
|
|
|
14
|
-
## Prerequisites
|
|
15
|
-
|
|
16
|
-
- Node.js >= 18
|
|
17
|
-
- VS Code
|
|
18
|
-
|
|
19
14
|
## Setup
|
|
20
15
|
|
|
21
16
|
### 1. Install the VS Code Extension
|
|
22
17
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
cd agentic-debugger
|
|
27
|
-
npm install
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
To run it in development mode, open the `agentic-debugger` folder in VS Code and press **F5** (or use **Run > Start Debugging**). This launches a new Extension Development Host window with the extension loaded.
|
|
31
|
-
|
|
32
|
-
The extension's launch configurations are in `.vscode/launch.json`:
|
|
33
|
-
- **Run Extension** — compiles with webpack in watch mode, then launches
|
|
34
|
-
- **Run Extension (No Watch)** — compiles once, then launches
|
|
35
|
-
|
|
36
|
-
Once active, the extension starts its bridge server on port **7070** (configurable via `agenticDebugger.bridgePort` in VS Code settings). If that port is taken, it falls back to an OS-assigned port. Either way, it writes the actual port to `~/.agentic-debugger/bridge-port`.
|
|
37
|
-
|
|
38
|
-
#### Extension Settings
|
|
39
|
-
|
|
40
|
-
| Setting | Default | Description |
|
|
41
|
-
|---|---|---|
|
|
42
|
-
| `agenticDebugger.bridgePort` | `7070` | Port for the bridge HTTP server |
|
|
43
|
-
| `agenticDebugger.anthropicApiKey` | `""` | Anthropic API key (for the built-in "Set Breakpoints" command) |
|
|
44
|
-
| `agenticDebugger.clearExistingBreakpoints` | `false` | Clear existing breakpoints before setting new ones |
|
|
18
|
+
Install [Agentic Debugger](https://open-vsx.org/extension/devinat1/agentic-debugger) on Cursor or Vscode. Once active, it starts a bridge server on port **7070** (configurable via `agenticDebugger.bridgePort` in VS Code settings).
|
|
45
19
|
|
|
46
20
|
### 2. Start the MCP Server
|
|
47
21
|
|
|
48
22
|
```bash
|
|
49
|
-
cd debugger-mcp-server
|
|
50
23
|
npm install
|
|
51
24
|
npm run build
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
Run it:
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
# Production (requires build first)
|
|
58
25
|
npm start
|
|
59
|
-
|
|
60
|
-
# Development (with hot reload via tsx)
|
|
61
|
-
npm run dev
|
|
62
26
|
```
|
|
63
27
|
|
|
64
|
-
The server starts on port **6090** by default. Override with
|
|
65
|
-
|
|
66
|
-
```bash
|
|
67
|
-
PORT=8080 npm start
|
|
68
|
-
```
|
|
28
|
+
The server starts on port **6090** by default. Override with `PORT=8080 npm start`.
|
|
69
29
|
|
|
70
30
|
### 3. Connect Your AI Agent
|
|
71
31
|
|
|
72
|
-
The MCP server uses **Streamable HTTP** transport at the `/mcp` endpoint.
|
|
73
|
-
|
|
74
32
|
Add this to your MCP client configuration (e.g. Claude Desktop, Claude Code, Cursor):
|
|
75
33
|
|
|
76
34
|
```json
|
|
@@ -83,12 +41,6 @@ Add this to your MCP client configuration (e.g. Claude Desktop, Claude Code, Cur
|
|
|
83
41
|
}
|
|
84
42
|
```
|
|
85
43
|
|
|
86
|
-
## Verifying the Setup
|
|
87
|
-
|
|
88
|
-
1. The extension is running when you see `Agentic Debugger: Bridge server listening on 127.0.0.1:7070.` in the VS Code **Output** panel (Extension Host log).
|
|
89
|
-
2. The MCP server is running when you see `Debugger MCP server running on port 6090.` in your terminal.
|
|
90
|
-
3. The MCP server finds the extension automatically via the port file at `~/.agentic-debugger/bridge-port`.
|
|
91
|
-
|
|
92
44
|
## Available Tools
|
|
93
45
|
|
|
94
46
|
| Category | Tool | Description |
|