aljaz/goose
1
0
Fork 0
mirror of https://github.com/aljazceru/goose.git synced 2025-12-17 14:14:26 +01:00
Code Issues Packages Projects Releases Wiki Activity

added tabs on tutorial TLDR blocks (#2487)

Browse Source
This commit is contained in:
w. ian douglas
2025-05-09 12:15:38 -06:00
committed by GitHub
parent 7b81562351
commit 6ec26715b9
24 changed files with 337 additions and 246 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
documentation/docs/tutorials/_template_.md
View File

@@ -12,18 +12,22 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [{name} MCP Server](/) as a Goose extension to enable file operations, repository management, search functionality, and more. This tutorial covers how to add the [{name} MCP Server](/) as a Goose extension to enable file operations, repository management, search functionality, and more.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer]({goose_url})
{command} </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variable** ```sh
``` {command}
{env_var}: <YOUR_TOKEN> ```
``` </TabItem>
</Tabs>
**Environment Variable**
```
{env_var}: <ENV_VALUE>
```
::: :::
## Configuration ## Configuration
@@ -42,7 +46,7 @@ Note that you'll need [JBang](https://www.jbang.dev/download) installed on your
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40hapins%2Ffigma-mcp&id=figma&name=Figma&description=Figma%20design%20tool%20integration&env=FIGMA_ACCESS_TOKEN%3DAccess%20token%20from%20Figma%20user%20settings) 1. [Launch the installer]({goose_url})
2. Press `Yes` to confirm the installation 2. Press `Yes` to confirm the installation
3. Obtain a [XYZ Access Token](/) and paste it in 3. Obtain a [XYZ Access Token](/) and paste it in
4. Click `Save Configuration` 4. Click `Save Configuration`

24
documentation/docs/tutorials/agentql-mcp.md
View File

@@ -12,15 +12,21 @@ This tutorial covers how to add the [AgentQL MCP Server](https://github.com/tiny
:::tip TLDR :::tip TLDR
**Command** <Tabs groupId="interface">
```sh <TabItem value="ui" label="Goose Desktop" default>
npx -y agentql-mcp [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=agentql-mcp&id=agentql&name=AgentQL&description=Transform%20unstructured%20web%20content%20into%20structured%20data&env=AGENTQL_API_KEY%3DAgentQL%20API%20Key)
``` </TabItem>
<TabItem value="cli" label="Goose CLI">
**Environment Variable** **Command**
``` ```sh
AGENTQL_API_KEY: <YOUR_API_KEY> npx -y agentql-mcp
``` ```
</TabItem>
</Tabs>
**Environment Variable**
```
AGENTQL_API_KEY: <YOUR_API_KEY>
```
::: :::
## Configuration ## Configuration

26
documentation/docs/tutorials/asana-mcp.md
View File

@@ -12,18 +12,22 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Asana MCP Server](https://github.com/roychri/mcp-server-asana) as a Goose extension to enable task automation, project tracking, and team collaboration. This tutorial covers how to add the [Asana MCP Server](https://github.com/roychri/mcp-server-asana) as a Goose extension to enable task automation, project tracking, and team collaboration.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40roychri%2Fmcp-server-asana&id=asana&name=Asana&description=enable%20task%20automation%2C%20project%20tracking%2C%20and%20team%20collaboration&env=ASANA_ACCESS_TOKEN%3DAsana%20Access%20Token)
npx -y @roychri/mcp-server-asana </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variable** ```sh
``` npx -y @roychri/mcp-server-asana
ASANA_ACCESS_TOKEN: <YOUR_TOKEN> ```
``` </TabItem>
</Tabs>
**Environment Variable**
```
ASANA_ACCESS_TOKEN: <YOUR_TOKEN>
```
::: :::
## Configuration ## Configuration

20
documentation/docs/tutorials/blender-mcp.md
View File

@@ -11,20 +11,24 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Blender MCP Server](https://github.com/ahujasid/blender-mcp) as a Goose extension to create 3D scenes, control Blender with natural language, generate models, apply materials, and more. This tutorial covers how to add the [Blender MCP Server](https://github.com/ahujasid/blender-mcp) as a Goose extension to create 3D scenes, control Blender with natural language, generate models, apply materials, and more.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=uvx&arg=blender-mcp&id=blender&name=Blender&description=Blender%203D%20scene%20creation%20integration)
uvx blender-mcp </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
uvx blender-mcp
```
</TabItem>
</Tabs>
:::
**Requirement** **Requirement**
Download [Blender Application](https://www.blender.org/download/) and [Blender MCP Addon file](https://github.com/ahujasid/blender-mcp/blob/main/addon.py) Download [Blender Application](https://www.blender.org/download/) and [Blender MCP Addon file](https://github.com/ahujasid/blender-mcp/blob/main/addon.py)
:::
## Configuration ## Configuration
:::info :::info

34
documentation/docs/tutorials/brave-mcp.md
View File

@@ -11,18 +11,22 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial will get you started with the [Brave Search MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search) as a Goose extension to enable interactive searches for both web and local searches. This tutorial will get you started with the [Brave Search MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search) as a Goose extension to enable interactive searches for both web and local searches.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40modelcontextprotocol%2Fserver-brave-search&id=brave-search&name=Brave%20Search&description=Brave%20Search%20API&env=BRAVE_API_KEY%3DYour%20API%20Key)
npx @modelcontextprotocol/server-brave-search </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variable** ```sh
``` npx -y @modelcontextprotocol/server-brave-search
BRAVE_API_KEY: <YOUR_API_KEY> ```
``` </TabItem>
</Tabs>
**Environment Variable**
```
BRAVE_API_KEY: <YOUR_API_KEY>
```
::: :::
## Configuration ## Configuration
@@ -93,7 +97,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ │
// highlight-start // highlight-start
◆ What command should be run? ◆ What command should be run?
│ npx @modelcontextprotocol/server-brave-search │ npx -y @modelcontextprotocol/server-brave-search
// highlight-end // highlight-end
└ └
``` ```
@@ -112,7 +116,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ brave-search │ brave-search
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @modelcontextprotocol/server-brave-search │ npx -y @modelcontextprotocol/server-brave-search
│ │
// highlight-start // highlight-start
◆ Please set the timeout for this tool (in secs): ◆ Please set the timeout for this tool (in secs):
@@ -136,7 +140,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ brave-search │ brave-search
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @modelcontextprotocol/server-brave-search │ npx -y @modelcontextprotocol/server-brave-search
│ │
◆ Please set the timeout for this tool (in secs): ◆ Please set the timeout for this tool (in secs):
│ 300 │ 300
@@ -167,7 +171,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ brave-search │ brave-search
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @modelcontextprotocol/server-brave-search │ npx -y @modelcontextprotocol/server-brave-search
│ │
◇ Please set the timeout for this tool (in secs): ◇ Please set the timeout for this tool (in secs):
│ 300 │ 300

25
documentation/docs/tutorials/elevenlabs-mcp.md
View File

@@ -13,16 +13,22 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [ElevenLabs MCP Server](https://github.com/yamadashy/repomix) as a Goose extension to enable AI-powered voice generation, voice cloning, audio editing, and speech-to-text transcription. This tutorial covers how to add the [ElevenLabs MCP Server](https://github.com/yamadashy/repomix) as a Goose extension to enable AI-powered voice generation, voice cloning, audio editing, and speech-to-text transcription.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
[Launch the installer](goose://extension?cmd=uvx&arg=elevenlabs-mcp&id=elevenlabs&name=ElevenLabs&description=ElevenLabs%20voice%20synthesis%20server&env=ELEVENLABS_API_KEY)
</TabItem>
<TabItem value="cli" label="Goose CLI">
**Command**
```sh
uvx elevenlabs-mcp
```
</TabItem>
</Tabs>
**Command** **Environment Variable**
```sh ```
uvx elevenlabs-mcp ELEVENLABS_API_KEY: <YOUR_API_KEY>
``` ```
**Environment Variable**
```
ELEVENLABS_API_KEY: <YOUR_API_KEY>
```
::: :::
## Configuration ## Configuration
@@ -31,7 +37,6 @@ ELEVENLABS_API_KEY: <YOUR_API_KEY>
Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`. Note that you'll need [uv](https://docs.astral.sh/uv/#installation) installed on your system to run this command, as it uses `uvx`.
::: :::
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
1. [Launch the installer](goose://extension?cmd=uvx&arg=elevenlabs-mcp&id=elevenlabs&name=ElevenLabs&description=ElevenLabs%20voice%20synthesis%20server&env=ELEVENLABS_API_KEY) 1. [Launch the installer](goose://extension?cmd=uvx&arg=elevenlabs-mcp&id=elevenlabs&name=ElevenLabs&description=ElevenLabs%20voice%20synthesis%20server&env=ELEVENLABS_API_KEY)

18
documentation/docs/tutorials/fetch-mcp.md
View File

@@ -15,16 +15,20 @@ The Fetch extension [does not work](https://github.com/block/goose/issues/1184)
This tutorial covers how to add the [Fetch MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch) as a Goose extension to retrieve and process content from the web. This tutorial covers how to add the [Fetch MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/fetch) as a Goose extension to retrieve and process content from the web.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=uvx&arg=mcp-server-fetch&id=fetch&name=Fetch&description=Web%20content%20fetching%20and%20processing%20capabilities)
uvx mcp-server-fetch </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
uvx mcp-server-fetch
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration
:::info :::info

34
documentation/docs/tutorials/figma-mcp.md
View File

@@ -12,18 +12,22 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Figma MCP Server](https://github.com/hapins/figma-mcp) as a Goose extension to enable interaction with Figma files, designs, and components. This tutorial covers how to add the [Figma MCP Server](https://github.com/hapins/figma-mcp) as a Goose extension to enable interaction with Figma files, designs, and components.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40hapins%2Ffigma-mcp&id=figma&name=Figma&description=Figma%20design%20tool%20integration&env=FIGMA_ACCESS_TOKEN%3DAccess%20token%20from%20Figma%20user%20settings)
npx @hapins/figma-mcp </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variable** ```sh
``` npx -y @hapins/figma-mcp
FIGMA_ACCESS_TOKEN: <YOUR_TOKEN> ```
``` </TabItem>
</Tabs>
**Environment Variable**
```
FIGMA_ACCESS_TOKEN: <YOUR_TOKEN>
```
::: :::
## Configuration ## Configuration
@@ -94,7 +98,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ │
// highlight-start // highlight-start
◆ What command should be run? ◆ What command should be run?
│ npx @hapins/figma-mcp │ npx -y @hapins/figma-mcp
// highlight-end // highlight-end
└ └
``` ```
@@ -113,7 +117,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ figma │ figma
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @hapins/figma-mcp │ npx -y @hapins/figma-mcp
│ │
// highlight-start // highlight-start
◆ Please set the timeout for this tool (in secs): ◆ Please set the timeout for this tool (in secs):
@@ -137,7 +141,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ figma │ figma
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @hapins/figma-mcp │ npx -y @hapins/figma-mcp
│ │
◇ Please set the timeout for this tool (in secs): ◇ Please set the timeout for this tool (in secs):
│ 300 │ 300
@@ -167,7 +171,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ figma │ figma
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @hapins/figma-mcp │ npx -y @hapins/figma-mcp
│ │
◇ Please set the timeout for this tool (in secs): ◇ Please set the timeout for this tool (in secs):
│ 300 │ 300

37
documentation/docs/tutorials/filesystem-mcp.md
View File

@@ -12,11 +12,18 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Filesystem MCP server](https://github.com/modelcontextprotocol/servers/tree/HEAD/src/filesystem) as a Goose extension, enabling powerful code analysis and file management. With this extension, Goose can analyze project structures, edit and organize files, detect unused dependencies, and generate documentation to improve software maintainability. This tutorial covers how to add the [Filesystem MCP server](https://github.com/modelcontextprotocol/servers/tree/HEAD/src/filesystem) as a Goose extension, enabling powerful code analysis and file management. With this extension, Goose can analyze project structures, edit and organize files, detect unused dependencies, and generate documentation to improve software maintainability.
:::tip TLDR :::tip TLDR
**Command** <Tabs groupId="interface">
```sh <TabItem value="ui" label="Goose Desktop" default>
npx -y @modelcontextprotocol/server-filesystem </path/to/allowed/directory> [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=@modelcontextprotocol/server-filesystem&arg=/path/to/allowed/directory&id=filesystem-mcp&name=Filesystem%20MCP%20Server&description=Filesystem%20MCP%20Server)
``` </TabItem>
You can specify multiple allowed directories by separating them with a space. <TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y @modelcontextprotocol/server-filesystem </path/to/allowed/directory>
```
</TabItem>
</Tabs>
You can specify multiple allowed directories by separating them with a space.
::: :::
## Configuration ## Configuration
@@ -27,22 +34,10 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=@modelcontextprotocol/server-filesystem&arg=/path/to/allowed/directory&id=filesystem-mcp&name=Filesystem%20MCP%20Server&description=Filesystem%20MCP%20Server)
1. Click `...` in the upper right corner 2. Press `Yes` to confirm the installation
2. Click `Advanced Settings` 3. Add additional allowed directories if desired, separated by a space.
3. Under `Extensions`, click the `Add` link 4. Click `Save Configuration`
4. On the `Add Extension Manually` modal, enter the following:
* **Type**: `Standard IO`
* **ID**: `filesystem-mcp` (_set this to whatever you want_)
* **Name**: `filesystem` (_set this to whatever you want_)
* **Description**: `filesystem MCP Server` (_set this to whatever you want_)
* **Command**: `npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory`
5. Click `Add Extension` button
:::tip Multiple Directories
You can specify multiple directories by separating them with a space.
:::
</TabItem> </TabItem>
<TabItem value="cli" label="Goose CLI"> <TabItem value="cli" label="Goose CLI">

25
documentation/docs/tutorials/github-mcp.md
View File

@@ -12,19 +12,24 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [GitHub MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/github) as a Goose extension to enable file operations, repository management, search functionality, and more. This tutorial covers how to add the [GitHub MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/github) as a Goose extension to enable file operations, repository management, search functionality, and more.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
[Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40modelcontextprotocol%2Fserver-github&id=github&name=GitHub&description=GitHub%20API&env=GITHUB_PERSONAL_ACCESS_TOKEN%3DGitHub%20Personal%20Access%20Token)
</TabItem>
<TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y @modelcontextprotocol/server-github
```
</TabItem>
</Tabs>
**Command** **Environment Variable**
```sh ```
npx -y @modelcontextprotocol/server-github GITHUB_PERSONAL_ACCESS_TOKEN: <YOUR_TOKEN>
``` ```
**Environment Variable**
```
GITHUB_PERSONAL_ACCESS_TOKEN: <YOUR_TOKEN>
```
::: :::
## Configuration ## Configuration
:::info :::info

41
documentation/docs/tutorials/google-drive-mcp.md
View File

@@ -12,28 +12,25 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Google Drive MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/gdrive) as a Goose extension, allowing you to list, read, and search files in Google Drive. This tutorial covers how to add the [Google Drive MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/gdrive) as a Goose extension, allowing you to list, read, and search files in Google Drive.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Authentication Command** <TabItem value="ui" label="Goose Desktop" default>
[Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40modelcontextprotocol%2Fserver-gdrive&id=google-drive&name=Google%20Drive&description=Google%20Drive%20integration&env=GDRIVE_CREDENTIALS_PATH%3DPath%20to%20Google%20Drive%20credentials&env=GDRIVE_OAUTH_PATH%3DPath%20to%20OAuth%20token)
In your terminal, run the following: </TabItem>
<TabItem value="cli" label="Goose CLI">
```sh **Command**
GDRIVE_OAUTH_PATH=/Users/<username>/.config/gcp-oauth.keys.json \ ```sh
GDRIVE_CREDENTIALS_PATH=/Users/<username>/.config/.gdrive-server-credentials.json \ GDRIVE_OAUTH_PATH=/Users/<username>/.config/gcp-oauth.keys.json \
npx -y @modelcontextprotocol/server-gdrive auth GDRIVE_CREDENTIALS_PATH=/Users/<username>/.config/.gdrive-server-credentials.json \
``` npx -y @modelcontextprotocol/server-gdrive auth
**Command** npx -y @modelcontextprotocol/server-gdrive
```sh ```
npx -y @modelcontextprotocol/server-gdrive </TabItem>
``` </Tabs>
**Environment Variable**
**Environment Variables** ```
``` GDRIVE_CREDENTIALS_PATH: ~/.config/.gdrive-server-credentials.json
GDRIVE_CREDENTIALS_PATH: ~/.config/.gdrive-server-credentials.json GDRIVE_OAUTH_PATH: ~/.config/gcp-oauth.keys.json
``` ```
```
GDRIVE_OAUTH_PATH: ~/.config/gcp-oauth.keys.json
```
::: :::
## Configuration ## Configuration

26
documentation/docs/tutorials/google-maps-mcp.md
View File

@@ -10,18 +10,22 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Google Maps MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps) as a Goose extension to enable geocoding, place searching, distance calculations, elevation data retrieval, and directions. This tutorial covers how to add the [Google Maps MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/google-maps) as a Goose extension to enable geocoding, place searching, distance calculations, elevation data retrieval, and directions.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40modelcontextprotocol%2Fserver-google-maps&id=google-maps&name=Google%20Maps&description=Google%20Maps%20API%20integration&env=GOOGLE_MAPS_API_KEY%3DGoogle%20Maps%20API%20key)
npx -y @modelcontextprotocol/server-google-maps </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variable** ```sh
``` npx -y @modelcontextprotocol/server-google-maps
GOOGLE_MAPS_API_KEY: <YOUR_TOKEN> ```
``` </TabItem>
</Tabs>
**Environment Variable**
```
GOOGLE_MAPS_API_KEY: <YOUR_TOKEN>
```
::: :::
## Configuration ## Configuration

16
documentation/docs/tutorials/knowledge-graph-mcp.md
View File

@@ -13,11 +13,17 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Knowledge Graph Memory MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) as a Goose extension. This enables Goose to analyze relationships, detect patterns, and gain a deeper understanding of your data. The knowledge graph builds on the [memory extension](/docs/tutorials/memory-mcp) by mapping complex relationships between concepts and providing persistent memory across Goose sessions. This tutorial covers how to add the [Knowledge Graph Memory MCP Server](https://github.com/modelcontextprotocol/servers/tree/main/src/memory) as a Goose extension. This enables Goose to analyze relationships, detect patterns, and gain a deeper understanding of your data. The knowledge graph builds on the [memory extension](/docs/tutorials/memory-mcp) by mapping complex relationships between concepts and providing persistent memory across Goose sessions.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40modelcontextprotocol%2Fserver-memory&id=knowledge_graph_memory&name=Knowledge%20Graph%20Memory&description=Graph-based%20memory%20system%20for%20persistent%20knowledge%20storage)
npx -y @modelcontextprotocol/server-memory </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y @modelcontextprotocol/server-memory
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration

31
documentation/docs/tutorials/mbot-mcp.md
View File

@@ -11,21 +11,24 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial will get you started with [deemkeen's MQTT MCP server](https://github.com/deemkeen/mbotmcp) for the [MakeBlock mbot2 rover](https://www.makeblock.com/products/buy-mbot2), and outline some code changes we made along the way. This tutorial will get you started with [deemkeen's MQTT MCP server](https://github.com/deemkeen/mbotmcp) for the [MakeBlock mbot2 rover](https://www.makeblock.com/products/buy-mbot2), and outline some code changes we made along the way.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=/path/to/java&arg=-jar&arg=/path/to/mbotmcp-0.0.1-SNAPSHOT.jar&name=mbot2&description=mbot2&env=MQTT_SERVER_URI%3Dtcp://1.2.3.4:1883&env=MQTT_USERNAME%3Dyour_username&env=MQTT_PASSWORD%3Dyour_password)
/path/to/java -jar /path/to/mbotmcp-0.0.1-SNAPSHOT.jar </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variables** ```sh
``` /path/to/java -jar /path/to/mbotmcp-0.0.1-SNAPSHOT.jar
MQTT_SERVER_URI: tcp://1.2.3.4:1883 ```
MQTT_PASSWORD: <string or blank> </TabItem>
MQTT_USERNAME: <string or blank> </Tabs>
``` **Environment Variable**
```
MQTT_SERVER_URI: tcp://1.2.3.4:1883
MQTT_PASSWORD: <string or blank>
MQTT_USERNAME: <string or blank>
```
::: :::
## Configuration ## Configuration

18
documentation/docs/tutorials/pdf-mcp.md
View File

@@ -12,13 +12,17 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [PDF Reader MCP Server](https://github.com/michaelneale/mcp-read-pdf) as a Goose extension, enabling Goose to read and extract text from protected and unprotected PDFs. This tutorial covers how to add the [PDF Reader MCP Server](https://github.com/michaelneale/mcp-read-pdf) as a Goose extension, enabling Goose to read and extract text from protected and unprotected PDFs.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
[Launch the installer](goose://extension?cmd=uvx&arg=mcp-read-pdf&id=pdf_read&name=PDF%20Reader&description=Read%20large%20and%20complex%20PDF%20documents)
```sh </TabItem>
uvx mcp-read-pdf <TabItem value="cli" label="Goose CLI">
``` **Command**
```sh
uvx mcp-read-pdf
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration

18
documentation/docs/tutorials/postgres-mcp.md
View File

@@ -10,11 +10,17 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
The PostgreSQL MCP Server extension allows Goose to interact directly with your PostgreSQL databases, enabling database operations, querying, and schema management capabilities. This makes it easy to work with your databases through natural language interactions. The PostgreSQL MCP Server extension allows Goose to interact directly with your PostgreSQL databases, enabling database operations, querying, and schema management capabilities. This makes it easy to work with your databases through natural language interactions.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=@modelcontextprotocol/server-postgres&arg=Your%20PostgreSQL%20connection%20URL&id=postgres&name=PostgreSQL&description=PostgreSQL%20database%20integration)
npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb
```
</TabItem>
</Tabs>
::: :::
## Customizing Your Connection ## Customizing Your Connection
@@ -52,7 +58,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=@modelcontextprotocol/server-postgres&id=postgres&name=PostgreSQL&description=PostgreSQL%20database%20integration&env=POSTGRES_URL%3DYour%20PostgreSQL%20connection%20URL) 1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=@modelcontextprotocol/server-postgres&arg=Your%20PostgreSQL%20connection%20URL&id=postgres&name=PostgreSQL&description=PostgreSQL%20database%20integration)
2. Press `Yes` to confirm the installation 2. Press `Yes` to confirm the installation
3. Enter your PostgreSQL connection URL in the format: `postgresql://username:password@hostname:5432/database` 3. Enter your PostgreSQL connection URL in the format: `postgresql://username:password@hostname:5432/database`
4. Click `Save Configuration` 4. Click `Save Configuration`

18
documentation/docs/tutorials/puppeteer-mcp.md
View File

@@ -11,15 +11,21 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Puppeteer MCP Server](https://github.com/modelcontextprotocol/servers/tree/HEAD/src/puppeteer) as a Goose extension, enabling Goose to interact with websites - navigating pages, filling forms, clicking buttons, taking screenshots, and executing JavaScript in a real browser environment. This tutorial covers how to add the [Puppeteer MCP Server](https://github.com/modelcontextprotocol/servers/tree/HEAD/src/puppeteer) as a Goose extension, enabling Goose to interact with websites - navigating pages, filling forms, clicking buttons, taking screenshots, and executing JavaScript in a real browser environment.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40modelcontextprotocol%2Fserver-puppeteer&id=puppeteer&name=Puppeteer&description=Headless%20browser%20automation)
npx -y @modelcontextprotocol/server-puppeteer </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y @modelcontextprotocol/server-puppeteer
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration
:::info :::info

18
documentation/docs/tutorials/repomix-mcp.md
View File

@@ -12,13 +12,18 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Repomix MCP Server](https://github.com/yamadashy/repomix) as a Goose extension to enable automated repository packing, codebase analysis, architecture summaries, test generation, and code exploration, all while compressing the codebase to minimize token usage and stay within your LLM's context limits. This tutorial covers how to add the [Repomix MCP Server](https://github.com/yamadashy/repomix) as a Goose extension to enable automated repository packing, codebase analysis, architecture summaries, test generation, and code exploration, all while compressing the codebase to minimize token usage and stay within your LLM's context limits.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=repomix&arg=--mcp&id=repomix&name=Repomix&description=Pack%20repositories%20into%20AI-friendly%20formats%20for%20Goose)
npx -y repomix --mcp </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y repomix --mcp
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration
@@ -27,7 +32,6 @@ npx -y repomix --mcp
Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`. Note that you'll need [Node.js](https://nodejs.org/) installed on your system to run this command, as it uses `npx`.
::: :::
<Tabs groupId="interface"> <Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default> <TabItem value="ui" label="Goose Desktop" default>
1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=repomix&arg=--mcp&id=repomix&name=Repomix&description=Pack%20repositories%20into%20AI-friendly%20formats%20for%20Goose) 1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=repomix&arg=--mcp&id=repomix&name=Repomix&description=Pack%20repositories%20into%20AI-friendly%20formats%20for%20Goose)

17
documentation/docs/tutorials/selenium-mcp.md
View File

@@ -12,13 +12,18 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Selenium MCP Server](https://github.com/angiejones/mcp-selenium) as a Goose extension to automate browser interactions such as navigating web pages and completing forms. This tutorial covers how to add the [Selenium MCP Server](https://github.com/angiejones/mcp-selenium) as a Goose extension to automate browser interactions such as navigating web pages and completing forms.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40angiejones%2Fmcp-selenium&id=selenium-mcp&name=Selenium%20MCP&description=automates%20browser%20interactions)
npx -y @angiejones/mcp-selenium </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y @angiejones/mcp-selenium
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration

24
documentation/docs/tutorials/speech-mcp.md
View File

@@ -12,18 +12,24 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Speech MCP Server](https://github.com/Kvadratni/speech-mcp) as a Goose extension to enable real-time voice interaction, audio/video transcription, text-to-speech conversion, and multi-speaker audio generation. This tutorial covers how to add the [Speech MCP Server](https://github.com/Kvadratni/speech-mcp) as a Goose extension to enable real-time voice interaction, audio/video transcription, text-to-speech conversion, and multi-speaker audio generation.
:::tip TLDR :::info Requirement
**Command**
```sh
uvx -p 3.10.14 speech-mcp@latest
```
**Requirement**
[PortAudio](https://github.com/GoogleCloudPlatform/python-docs-samples/blob/main/scripts/readme-gen/templates/install_portaudio.tmpl.rst#install-portaudio) is required for PyAudio to capture audio from your microphone [PortAudio](https://github.com/GoogleCloudPlatform/python-docs-samples/blob/main/scripts/readme-gen/templates/install_portaudio.tmpl.rst#install-portaudio) is required for PyAudio to capture audio from your microphone
::: :::
:::tip TLDR
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
[Launch the installer](goose://extension?cmd=uvx&&arg=-p&arg=3.10.14&arg=speech-mcp@latest&id=speech_mcp&name=Speech%20Interface&description=Voice%20interaction%20with%20audio%20visualization%20for%20Goose)
</TabItem>
<TabItem value="cli" label="Goose CLI">
**Command**
```sh
uvx -p 3.10.14 speech-mcp@latest
```
</TabItem>
</Tabs>
:::
## Configuration ## Configuration
:::info :::info

5
documentation/docs/tutorials/square-mcp.md
View File

@@ -202,16 +202,15 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
```sh ```sh
npx square-mcp-server start npx square-mcp-server start
``` ```
</TabItem>
</Tabs>
**Environment Variables** **Environment Variables**
``` ```
ACCESS_TOKEN: <YOUR_API_KEY> ACCESS_TOKEN: <YOUR_API_KEY>
SANDBOX: <true/false> SANDBOX: <true/false>
PRODUCTION: <true/false> PRODUCTION: <true/false>
``` ```
</TabItem>
</Tabs>
Note that you'll use `SANDBOX` -or- `PRODUCTION`, not both, and your `ACCESS_TOKEN` will either be a sandbox or production token, depending on which environment you choose. Note that you'll use `SANDBOX` -or- `PRODUCTION`, not both, and your `ACCESS_TOKEN` will either be a sandbox or production token, depending on which environment you choose.
::: :::

25
documentation/docs/tutorials/tavily-mcp.md
View File

@@ -12,16 +12,21 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [Tavily Web Search MCP Server](https://github.com/tavily-ai/tavily-mcp) as a Goose extension to enable AI-powered web search functionality. This tutorial covers how to add the [Tavily Web Search MCP Server](https://github.com/tavily-ai/tavily-mcp) as a Goose extension to enable AI-powered web search functionality.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=tavily-mcp&id=tavily&name=Tavily%20Web%20Search&description=Search%20the%20web%20with%20Tavily%20MCP&env=TAVILY_API_KEY%3DTavily%20API%20Key)
npx -y tavily-mcp </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
**Environment Variable** ```sh
``` npx -y tavily-mcp
TAVILY_API_KEY: <YOUR_API_KEY> ```
``` </TabItem>
</Tabs>
**Environment Variable**
```
TAVILY_API_KEY: <YOUR_API_KEY>
```
::: :::
## Configuration ## Configuration

31
documentation/docs/tutorials/vscode-mcp.md
View File

@@ -12,18 +12,25 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [VS Code MCP Server](https://github.com/block/vscode-mcp) as a Goose extension to enable VS Code integration, file operations, and development workflow management. This tutorial covers how to add the [VS Code MCP Server](https://github.com/block/vscode-mcp) as a Goose extension to enable VS Code integration, file operations, and development workflow management.
:::tip TLDR :::info Required Setup
**Command**
```sh
npx vscode-mcp-server
```
**Required Setup**
Install the [VS Code MCP Extension](https://marketplace.visualstudio.com/items?itemName=block.vscode-mcp-extension) from the Visual Studio Marketplace. Install the [VS Code MCP Extension](https://marketplace.visualstudio.com/items?itemName=block.vscode-mcp-extension) from the Visual Studio Marketplace.
::: :::
:::tip TLDR
<Tabs groupId="interface">
<TabItem value="ui" label="Goose Desktop" default>
[Launch the installer](goose://extension?cmd=npx&arg=-y&arg=vscode-mcp-server&id=vscode-mcp&name=VS%20Code%20MCP&description=VS%20Code%20integration%20and%20file%20operations)
</TabItem>
<TabItem value="cli" label="Goose CLI">
**Command**
```sh
npx -y vscode-mcp-server
```
</TabItem>
</Tabs>
:::
## Configuration ## Configuration
:::info :::info
@@ -93,7 +100,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ │
// highlight-start // highlight-start
◆ What command should be run? ◆ What command should be run?
│ npx vscode-mcp-server │ npx -y vscode-mcp-server
// highlight-end // highlight-end
└ └
``` ```
@@ -112,7 +119,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ vscode-mcp │ vscode-mcp
│ │
◇ What command should be run? ◇ What command should be run?
│ npx vscode-mcp-server install │ npx -y vscode-mcp-server install
│ │
// highlight-start // highlight-start
◆ Please set the timeout for this tool (in secs): ◆ Please set the timeout for this tool (in secs):
@@ -136,7 +143,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ vscode-mcp │ vscode-mcp
│ │
◇ What command should be run? ◇ What command should be run?
│ npx vscode-mcp-server install │ npx -y vscode-mcp-server install
│ │
◆ Please set the timeout for this tool (in secs): ◆ Please set the timeout for this tool (in secs):
│ 300 │ 300

24
documentation/docs/tutorials/youtube-transcript.md
View File

@@ -12,13 +12,17 @@ import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';
This tutorial covers how to add the [YouTube Transcript MCP Server](https://github.com/jkawamoto/mcp-youtube-transcript) as a Goose extension to enable fetching and working with YouTube video transcripts. This tutorial covers how to add the [YouTube Transcript MCP Server](https://github.com/jkawamoto/mcp-youtube-transcript) as a Goose extension to enable fetching and working with YouTube video transcripts.
:::tip TLDR :::tip TLDR
<Tabs groupId="interface">
**Command** <TabItem value="ui" label="Goose Desktop" default>
```sh [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=%40jkawamoto%2Fmcp-youtube-transcript&id=youtube-transcript&name=YouTube%20Transcript&description=Access%20YouTube%20video%20transcripts)
npx @jkawamoto/mcp-youtube-transcript </TabItem>
``` <TabItem value="cli" label="Goose CLI">
**Command**
No environment variables are required for this extension. ```sh
npx -y @jkawamoto/mcp-youtube-transcript
```
</TabItem>
</Tabs>
::: :::
## Configuration ## Configuration
@@ -88,7 +92,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ │
// highlight-start // highlight-start
◆ What command should be run? ◆ What command should be run?
│ npx @jkawamoto/mcp-youtube-transcript │ npx -y @jkawamoto/mcp-youtube-transcript
// highlight-end // highlight-end
└ └
``` ```
@@ -107,7 +111,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ youtube-transcript │ youtube-transcript
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @jkawamoto/mcp-youtube-transcript │ npx -y @jkawamoto/mcp-youtube-transcript
│ │
// highlight-start // highlight-start
◆ Please set the timeout for this tool (in secs): ◆ Please set the timeout for this tool (in secs):
@@ -158,7 +162,7 @@ Note that you'll need [Node.js](https://nodejs.org/) installed on your system to
│ youtube-transcript │ youtube-transcript
│ │
◇ What command should be run? ◇ What command should be run?
│ npx @jkawamoto/mcp-youtube-transcript │ npx -y @jkawamoto/mcp-youtube-transcript
│ │
◇ Please set the timeout for this tool (in secs): ◇ Please set the timeout for this tool (in secs):
│ 300 │ 300