@suco/su-auggie-mcp 0.1.0 → 0.1.4
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/README.md +50 -18
- package/dist/workspace.js +6 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,20 +1,8 @@
|
|
|
1
1
|
# @suco/su-auggie-mcp
|
|
2
2
|
|
|
3
|
-
An MCP (Model Context Protocol) server
|
|
3
|
+
An MCP (Model Context Protocol) server by [Solutions Unity](https://solutionsunity.com) utilizing the [Augment Code SDK](https://www.npmjs.com/package/@augmentcode/auggie-sdk) to expose context engine capabilities.
|
|
4
4
|
|
|
5
|
-
> ⚠️ **Experimental** — This package is a test implementation
|
|
6
|
-
|
|
7
|
-
## Installation
|
|
8
|
-
|
|
9
|
-
```bash
|
|
10
|
-
npm install -g @suco/su-auggie-mcp
|
|
11
|
-
```
|
|
12
|
-
|
|
13
|
-
Or use with npx:
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
npx @suco/su-auggie-mcp
|
|
17
|
-
```
|
|
5
|
+
> ⚠️ **Experimental** — This package is a test implementation. Use at your own risk.
|
|
18
6
|
|
|
19
7
|
## Usage
|
|
20
8
|
|
|
@@ -25,17 +13,61 @@ Add to your MCP client configuration:
|
|
|
25
13
|
```json
|
|
26
14
|
{
|
|
27
15
|
"mcpServers": {
|
|
28
|
-
"
|
|
16
|
+
"auggie": {
|
|
29
17
|
"command": "npx",
|
|
30
|
-
"args": ["@suco/su-auggie-mcp"]
|
|
18
|
+
"args": ["@suco/su-auggie-mcp", "--debug"],
|
|
19
|
+
"alwaysAllow": ["codebase", "index", "debug"]
|
|
31
20
|
}
|
|
32
21
|
}
|
|
33
22
|
}
|
|
34
23
|
```
|
|
35
24
|
|
|
25
|
+
### Options
|
|
26
|
+
|
|
27
|
+
| Option | Description |
|
|
28
|
+
|--------|-------------|
|
|
29
|
+
| `-w, --workspace <path>` | Add workspace path (can be repeated or comma-separated) |
|
|
30
|
+
| `--ignore-roots` | Ignore MCP roots and CWD fallback, use only `-w` workspaces |
|
|
31
|
+
| `--debug` | Enable debug mode (logging capability + debug tool) |
|
|
32
|
+
| `-n, --no-persistent` | Disable index persistence (in-memory only, re-indexes on restart) |
|
|
33
|
+
|
|
36
34
|
### Environment Variables
|
|
37
35
|
|
|
38
|
-
|
|
36
|
+
| Variable | Description |
|
|
37
|
+
|----------|-------------|
|
|
38
|
+
| `AUGMENT_API_KEY` | Your Augment Code API key (required) |
|
|
39
|
+
| `AUGMENT_API_URL` | Augment API base URL (optional, for custom endpoints) |
|
|
40
|
+
| `SUCO_AUGGIE_DEBUG` | Set to `1` to enable debug mode |
|
|
41
|
+
|
|
42
|
+
## Tools
|
|
43
|
+
|
|
44
|
+
### `codebase`
|
|
45
|
+
|
|
46
|
+
Semantic search and Q&A over indexed code.
|
|
47
|
+
|
|
48
|
+
| Parameter | Type | Description |
|
|
49
|
+
|-----------|------|-------------|
|
|
50
|
+
| `mode` | `"search"` \| `"ask"` | Operation mode: search for code or ask a question |
|
|
51
|
+
| `query` | `string` | Natural language search query |
|
|
52
|
+
| `prompt` | `string?` | Additional prompt for ask mode (optional) |
|
|
53
|
+
| `root` | `string?` | Workspace root path (optional) |
|
|
54
|
+
|
|
55
|
+
### `index`
|
|
56
|
+
|
|
57
|
+
Manage and inspect codebase indexing state.
|
|
58
|
+
|
|
59
|
+
| Parameter | Type | Description |
|
|
60
|
+
|-----------|------|-------------|
|
|
61
|
+
| `action` | `"status"` \| `"list"` \| `"reindex"` | Action to perform |
|
|
62
|
+
|
|
63
|
+
### `debug` (only with `--debug`)
|
|
64
|
+
|
|
65
|
+
Inspect internal server state for troubleshooting.
|
|
66
|
+
|
|
67
|
+
| Parameter | Type | Description |
|
|
68
|
+
|-----------|------|-------------|
|
|
69
|
+
| `action` | `"state"` \| `"stats"` \| `"config"` \| `"capabilities"` \| `"emit"` | Debug action |
|
|
70
|
+
| `root` | `string?` | Workspace root path (optional) |
|
|
39
71
|
|
|
40
72
|
## Requirements
|
|
41
73
|
|
|
@@ -43,5 +75,5 @@ Add to your MCP client configuration:
|
|
|
43
75
|
|
|
44
76
|
## License
|
|
45
77
|
|
|
46
|
-
|
|
78
|
+
This package is subject to the [Augment Code SDK](https://www.npmjs.com/package/@augmentcode/auggie-sdk) license and usage terms. Solutions Unity provides no warranties, guarantees, or support obligations.
|
|
47
79
|
|
package/dist/workspace.js
CHANGED
|
@@ -559,11 +559,7 @@ export class Workspace {
|
|
|
559
559
|
}
|
|
560
560
|
/** Get workspace status */
|
|
561
561
|
getStatus() {
|
|
562
|
-
//
|
|
563
|
-
const progressPending = this.progress
|
|
564
|
-
? this.progress.discovered - this.progress.indexed
|
|
565
|
-
: 0;
|
|
566
|
-
// Get stats from FileIndexer
|
|
562
|
+
// Get stats from FileIndexer first (needed for pending calculation)
|
|
567
563
|
const stats = this.fileIndexer?.getStats() ?? {
|
|
568
564
|
indexed: 0,
|
|
569
565
|
skipped: 0,
|
|
@@ -574,6 +570,11 @@ export class Workspace {
|
|
|
574
570
|
cooldownCycle: 0,
|
|
575
571
|
cooldownNextRetryAt: null,
|
|
576
572
|
};
|
|
573
|
+
// Pending = discovered - (indexed + skipped + failed from FileIndexer)
|
|
574
|
+
// This avoids double-counting skipped files as both skipped AND pending
|
|
575
|
+
const progressPending = this.progress
|
|
576
|
+
? Math.max(0, this.progress.discovered - stats.indexed - stats.skipped - stats.failed)
|
|
577
|
+
: 0;
|
|
577
578
|
const metrics = this.fileIndexer?.getBatcherMetrics() ?? {
|
|
578
579
|
currentConcurrency: 0,
|
|
579
580
|
peakConcurrency: 0,
|