@suco/su-auggie-mcp

An MCP (Model Context Protocol) server by Solutions Unity utilizing the Augment Code SDK to expose context engine capabilities.

⚠️ Experimental — This package is a test implementation. Use at your own risk.

Usage

As an MCP Server

Add to your MCP client configuration:

{
  "mcpServers": {
    "auggie": {
      "command": "npx",
      "args": ["@suco/su-auggie-mcp@latest", "--debug"],
      "alwaysAllow": ["codebase", "index", "debug"]
    }
  }
}

Note: Using @latest ensures you always get the newest version. Without it, npx caches the package and won't pick up updates on restart.

Options

| Option | Description | |--------|-------------| | -w, --workspace <path> | Add workspace path (can be repeated or comma-separated) | | --ignore-roots | Ignore MCP roots and CWD fallback, use only -w workspaces | | --debug | Enable debug mode (logging capability + debug tool) | | -n, --no-persistent | Disable index persistence (in-memory only, re-indexes on restart) |

Environment Variables

| Variable | Description | |----------|-------------| | AUGMENT_API_KEY | Your Augment Code API key (required) | | AUGMENT_API_URL | Augment API base URL (optional, for custom endpoints) | | SUCO_AUGGIE_DEBUG | Set to 1 to enable debug mode |

Tools

codebase

Semantic search and Q&A over indexed code.

| Parameter | Type | Description | |-----------|------|-------------| | mode | "search" | "ask" | Operation mode: search for code or ask a question | | query | string | Natural language search query | | prompt | string? | Additional prompt for ask mode (optional) | | root | string? | Workspace root path (optional) |

index

Manage and inspect codebase indexing state.

| Parameter | Type | Description | |-----------|------|-------------| | action | "status" | "list" | "reindex" | Action to perform |

debug (only with --debug)

Inspect internal server state for troubleshooting.

| Parameter | Type | Description | |-----------|------|-------------| | action | "state" | "stats" | "config" | "capabilities" | "emit" | Debug action | | root | string? | Workspace root path (optional) |

Requirements

• Node.js >= 20

License

This package is subject to the Augment Code SDK license and usage terms. Solutions Unity provides no warranties, guarantees, or support obligations.