diff --git a/documentation/docs/mcp/sugar-mcp.mdx b/documentation/docs/mcp/sugar-mcp.mdx new file mode 100644 index 000000000000..dd57022f9dfb --- /dev/null +++ b/documentation/docs/mcp/sugar-mcp.mdx @@ -0,0 +1,127 @@ +--- +title: Sugar Extension +description: Add Sugar MCP Server as a goose Extension +--- + +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; +import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; +import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller'; + +This tutorial covers how to add the [Sugar MCP Server](https://github.com/cdnsteve/sugar) as a goose extension to delegate development tasks to an autonomous AI system that runs in the background. + +:::tip TLDR + + + [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=sugarai-mcp&id=sugar&name=Sugar&description=Autonomous%20AI%20development%20system%20-%20delegate%20tasks%20and%20run%2024%2F7&env=SUGAR_PROJECT_ROOT%3DProject%20directory%20(optional%2C%20defaults%20to%20current)) + + When prompted, set `SUGAR_PROJECT_ROOT` to your project path. + + + **Command** + ```sh + npx -y sugarai-mcp + ``` + Runs in your current directory by default. + + +::: + +## Configuration + +:::info +Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`. +::: + +:::info +Sugar requires Python 3.11+ and the Sugar CLI installed in your project. Install with `pip install sugarai` and initialize with `sugar init`. +::: + + + + + + + + Set SUGAR_PROJECT_ROOT to your project directory, or Sugar will use the current working directory. + + } + /> + + + +## Example Usage + +Sugar lets you delegate development tasks to an autonomous AI that works in the background. Tasks are queued and executed independently, so you can continue working while Sugar handles them. + + + + 1. Open a new session in goose Desktop + + + + 1. Open a terminal and start a new goose session: + + ```sh + goose session + ``` + + + + +### goose Prompt + +> Create a task to add input validation to the user registration form. Priority 4. + +### goose Output + +:::note Desktop + +I'll create a Sugar task for adding input validation to the user registration form. + +-------- createTask ------- + +Task created successfully: +- **ID**: a1b2c3d4-5678-90ab-cdef-ghijklmnopqr +- **Title**: Add input validation to the user registration form +- **Type**: feature +- **Priority**: P4 (High) +- **Status**: pending + +The task has been queued. Sugar will pick it up and work on it autonomously. You can check the status anytime with `getStatus` or `listTasks`. + +::: + +### Available Tools + +Sugar exposes the following tools through MCP: + +| Tool | Description | +|------|-------------| +| `createTask` | Create a new development task | +| `listTasks` | List tasks with optional filtering | +| `viewTask` | View detailed task information | +| `updateTask` | Update task properties | +| `removeTask` | Remove a task from the queue | +| `getStatus` | Get system status and metrics | +| `runOnce` | Execute one autonomous development cycle | +| `initSugar` | Initialize Sugar in a project | diff --git a/documentation/static/servers.json b/documentation/static/servers.json index bae762ced854..ce462f5573ea 100644 --- a/documentation/static/servers.json +++ b/documentation/static/servers.json @@ -640,6 +640,23 @@ } ] }, + { + "id": "sugar", + "name": "Sugar", + "description": "Autonomous AI development system - delegate tasks, run 24/7, auto-discover work from errors and GitHub issues", + "command": "npx -y sugarai-mcp", + "link": "https://github.com/cdnsteve/sugar", + "installation_notes": "Requires Python 3.11+ and Sugar CLI: pip install sugarai && sugar init", + "is_builtin": false, + "endorsed": false, + "environmentVariables": [ + { + "name": "SUGAR_PROJECT_ROOT", + "description": "Project directory for Sugar operations (defaults to current directory)", + "required": false + } + ] + }, { "id": "tavily", "name": "Tavily Web Search",