Adds `linux-mcp-server` to the goose registry by elianerpereira · Pull Request #6979 · block/goose

elianerpereira · 2026-02-05T13:54:06Z

Summary

This PR adds the linux-mcp-server to the goose registry.

Type of Change

AI Assistance

This PR was created or reviewed with AI assistance

Testing

Related Issues

Relates to #ISSUE_ID
Discussion: LINK (if any)

Screenshots/Demos (for UX changes)

Before:

After:

Signed-off-by: Eliane Pereira <[email protected]> Signed-off-by: Rodolfo Olivieri <[email protected]>

dianed-square · 2026-02-06T00:34:58Z

documentation/static/servers.json

+      {
+        "name": "LINUX_MCP_USER",
+        "description": "Default username for SSH connections",
+        "required": false,


Please remove all the trailing commas after these "required": false lines, otherwise they'll break the Extensions page.

But I'd suggest keeping only the 2-3 most commonly used env vars in this file (like LINUX_MCP_USER, LINUX_MCP_SSH_KEY_PATH, and LINUX_MCP_VERIFY_HOST_KEYS) and removing the rest. Instead, you can link directly to https://rhel-lightspeed.github.io/linux-mcp-server/clients/#environment-variables from the linux-mcp.md tutorial for the full and always up-to-date list.

Thanks for the feedback. I will remove the comma after "required": false lines.

@r0x0d please, do you agree to keep only the 2-3 most commonly used env vars in this file and add a link directly to https://rhel-lightspeed.github.io/linux-mcp-server/clients/#environment-variables from the linux-mcp.md tutorial for the full and always up-to-date list?
Thank you.

Hi! Yeah, I think it makes sense. We can go with LINUX_MCP_USER, LINUX_MCP_SSH_KEY_PATH and LINUX_MCP_VERIFY_HOST_KEYS as suggested.

dianed-square · 2026-02-06T00:35:08Z

documentation/docs/mcp/linux-mcp.md

@@ -0,0 +1,88 @@
+---
+title: Linux MCP server Extension


Nit - Please upper cap "Server" or even remove it "Linux MCP Extension"

dianed-square · 2026-02-06T00:35:42Z

documentation/docs/mcp/linux-mcp.md

+import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller';
+import GooseBuiltinInstaller from '@site/src/components/GooseBuiltinInstaller';
+
+<YouTubeShortEmbed videoUrl="https://www.youtube.com/embed/VIDEO_ID" />


Please remove this unless you have a video link to add

dianed-square · 2026-02-06T00:40:18Z

documentation/docs/mcp/linux-mcp.md

+:::tip TLDR
+<Tabs groupId="interface">
+  <TabItem value="ui" label="goose Desktop" default>
+  [Install Linux MCP server](https://rhel-lightspeed.github.io/linux-mcp-server/install/)


Should be something like this (I copied the autogenerated link in the Desktop tab):
Launch the installer

dianed-square · 2026-02-06T00:47:03Z

documentation/docs/mcp/linux-mcp.md

+
+- *Python 3.10* or later.
+- *goose* installed and configured.
+- *Sudo privileges (for certain diagnostic tools used by the server)*.
+


Note that you'll need uv installed on your system to run this command, as it uses uvx. Some diagnostic tools may require sudo privileges on the target Linux system.

goose suggested this instead to align with our template for uvx extensions and said that uv handles Python dependencies automatically, so no need to mention Python 3.10.

dianed-square · 2026-02-06T00:54:32Z

documentation/static/servers.json

+    "description": "Tools to allow LLM clients to interact with Linux systems remotely",
+    "command": "uvx linux-mcp-server",
+    "link": "https://github.com/rhel-lightspeed/linux-mcp-server",
+    "installation_notes": "Install using uvx package manager. Note: This is a read-only mcp server to discovering and interacting with remote/local systems.",


Nit - "for discovering"?

dianed-square · 2026-02-06T01:10:59Z

Thanks for contributing @elianerpereira ! This looks like a good one.

One more change request:
The auto-generated docs link from the extension card is based on your server id. Currently the link returns a 404, so to get it to work, the easiest option is ONE of the following:

Change your id from linux-mcp-server to linux-mcp in servers.json (and for consistency, also the Desktop/CLI components and goose:// URL in the TLDR box in the tutorial)
Change your tutorial file name from docs/mcp/linux-mcp.md → docs/mcp/linux-mcp-server-mcp.md

If you want, try out the Add MCP Server recipe that should be able help with this and other changes.

samdoran · 2026-02-06T21:15:41Z

documentation/docs/mcp/linux-mcp.md

+
+- *Python 3.10* or later.
+- *goose* installed and configured.
+- *Sudo privileges (for certain diagnostic tools used by the server)*.


Currently the tools don't use sudo so you can remove this line.

- Upper cap "Server" - Removes link to YouTube - Updates TLDR section - Updates prerequisite section - Changes tutorial name: docs/mcp/linux-mcp.md → docs/mcp/linux-mcp-server-mcp.md Signed-off-by: Eliane Pereira <[email protected]>

- Removes all the trailing commas after these "required": false lines - Keeps only the most commonly used env vars in the file, such as LINUX_MCP_USER, LINUX_MCP_SSH_KEY_PATH, and LINUX_MCP_VERIFY_HOST_KEYS, and adds link #environment-variables for the full and always up-to-date list. Signed-off-by: Eliane Pereira <[email protected]>

@angiejones

…deps * origin/main: (34 commits) fix: reduce server log verbosity — skip session in instrument, defaul… (#7729) fix: provider test infrastructure (#7738) fix: sanitize streamable HTTP extension names derived from URLs (#7740) refactor: derive GooseMode string conversions with strum (#7706) docs: Add Spraay Batch Payments MCP Extension Tutorial (#7525) fix: flake.nix (#7224) delete goose web (#7696) Add @angiejones as CODEOWNER for documentation (#7711) Add MLflow integration guide (#7563) docs: LM Studio availability (#7698) feat: add Avian as an LLM provider (#7561) Adds `linux-mcp-server` to the goose registry (#6979) fix: add #[serde(default)] to description field on 4 ExtensionConfig variants (#7708) feat: combine TUI UX from alexhancock/tui-goodness with publishing config from jackamadeo/package-tui (#7683) chore: cleanup old sandbox (#7700) Correct windows artifact (#7699) gh fall back (#7695) fix: restore smart-approve mode (#7690) fix: make TLS configurable in goosed agent via GOOSE_TLS env var (#7686) Update to rmcp 1.1.0 (#7619) ... # Conflicts: # Cargo.lock

@angiejones

* origin/main: (21 commits) fix(ui-desktop): unify path resolution around GOOSE_PATH_ROOT (#7335) fix: pass OAuth scopes to DCR and extract granted_scopes from token response (#7571) fix: write to real file if config.yaml is symlink (#7669) fix: preserve pairings when stopping gateway (#7733) fix: reduce server log verbosity — skip session in instrument, defaul… (#7729) fix: provider test infrastructure (#7738) fix: sanitize streamable HTTP extension names derived from URLs (#7740) refactor: derive GooseMode string conversions with strum (#7706) docs: Add Spraay Batch Payments MCP Extension Tutorial (#7525) fix: flake.nix (#7224) delete goose web (#7696) Add @angiejones as CODEOWNER for documentation (#7711) Add MLflow integration guide (#7563) docs: LM Studio availability (#7698) feat: add Avian as an LLM provider (#7561) Adds `linux-mcp-server` to the goose registry (#6979) fix: add #[serde(default)] to description field on 4 ExtensionConfig variants (#7708) feat: combine TUI UX from alexhancock/tui-goodness with publishing config from jackamadeo/package-tui (#7683) chore: cleanup old sandbox (#7700) Correct windows artifact (#7699) ...

@angiejones

* origin/main: (21 commits) fix(ui-desktop): unify path resolution around GOOSE_PATH_ROOT (#7335) fix: pass OAuth scopes to DCR and extract granted_scopes from token response (#7571) fix: write to real file if config.yaml is symlink (#7669) fix: preserve pairings when stopping gateway (#7733) fix: reduce server log verbosity — skip session in instrument, defaul… (#7729) fix: provider test infrastructure (#7738) fix: sanitize streamable HTTP extension names derived from URLs (#7740) refactor: derive GooseMode string conversions with strum (#7706) docs: Add Spraay Batch Payments MCP Extension Tutorial (#7525) fix: flake.nix (#7224) delete goose web (#7696) Add @angiejones as CODEOWNER for documentation (#7711) Add MLflow integration guide (#7563) docs: LM Studio availability (#7698) feat: add Avian as an LLM provider (#7561) Adds `linux-mcp-server` to the goose registry (#6979) fix: add #[serde(default)] to description field on 4 ExtensionConfig variants (#7708) feat: combine TUI UX from alexhancock/tui-goodness with publishing config from jackamadeo/package-tui (#7683) chore: cleanup old sandbox (#7700) Correct windows artifact (#7699) ...

@angiejones

…e-issue * origin/main: fix(ui-desktop): unify path resolution around GOOSE_PATH_ROOT (#7335) fix: pass OAuth scopes to DCR and extract granted_scopes from token response (#7571) fix: write to real file if config.yaml is symlink (#7669) fix: preserve pairings when stopping gateway (#7733) fix: reduce server log verbosity — skip session in instrument, defaul… (#7729) fix: provider test infrastructure (#7738) fix: sanitize streamable HTTP extension names derived from URLs (#7740) refactor: derive GooseMode string conversions with strum (#7706) docs: Add Spraay Batch Payments MCP Extension Tutorial (#7525) fix: flake.nix (#7224) delete goose web (#7696) Add @angiejones as CODEOWNER for documentation (#7711) Add MLflow integration guide (#7563) docs: LM Studio availability (#7698) feat: add Avian as an LLM provider (#7561) Adds `linux-mcp-server` to the goose registry (#6979) fix: add #[serde(default)] to description field on 4 ExtensionConfig variants (#7708)

elianerpereira requested a review from a team as a code owner February 5, 2026 13:54

Adds linux-mcp-server to the goose registry

bb91979

Signed-off-by: Eliane Pereira <[email protected]> Signed-off-by: Rodolfo Olivieri <[email protected]>

elianerpereira force-pushed the linux-mcp-server branch from 2ca6c60 to bb91979 Compare February 5, 2026 15:06

dianed-square reviewed Feb 6, 2026

View reviewed changes

samdoran reviewed Feb 6, 2026

View reviewed changes

elpereir added 2 commits February 9, 2026 14:22

Fixes as per reviews

7f52750

- Upper cap "Server" - Removes link to YouTube - Updates TLDR section - Updates prerequisite section - Changes tutorial name: docs/mcp/linux-mcp.md → docs/mcp/linux-mcp-server-mcp.md Signed-off-by: Eliane Pereira <[email protected]>

elianerpereira force-pushed the linux-mcp-server branch from af49e90 to b31d20e Compare February 9, 2026 13:22

blackgirlbytes approved these changes Mar 7, 2026

View reviewed changes

blackgirlbytes added this pull request to the merge queue Mar 7, 2026

Merged via the queue into block:main with commit ffa2f15 Mar 7, 2026
21 checks passed

r0x0d deleted the linux-mcp-server branch March 7, 2026 19:11

github-actions bot mentioned this pull request Mar 10, 2026

chore(release): release version 1.28.0 (minor) #7780

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Adds `linux-mcp-server` to the goose registry#6979

Adds `linux-mcp-server` to the goose registry#6979
blackgirlbytes merged 3 commits intoblock:mainfrom
elianerpereira:linux-mcp-server

elianerpereira commented Feb 5, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

elianerpereira Feb 6, 2026

Uh oh!

r0x0d Feb 6, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

dianed-square Feb 6, 2026

Uh oh!

dianed-square commented Feb 6, 2026

Uh oh!

samdoran Feb 6, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Conversation

elianerpereira commented Feb 5, 2026

Summary

Type of Change

AI Assistance

Testing

Related Issues

Screenshots/Demos (for UX changes)

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dianed-square commented Feb 6, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants