pod
Other formats agents might prefer:
markdownjsonllms.txt

Agent? You probably want markdown or json, or Pod over MCP.

Reported issues for linux-mcp-server

Pod holds 19 of 25 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to linux-mcp-server.

Most discussed

Feature request: jump host / bastion host support for remote targets

First of all, thank you very much for building this tool. It has been very helpful for my Linux operations and troubleshooting workflows on Kubernetes cluster nodes and bare-metal machines, and it has significantly improved my efficiency when using AI agents to inspect and analyze Linux servers. I would love to see the project continue to grow and become even more capable.

In my current usage scenarios, I sometimes run into cases where certain target Linux nodes are not directly reachable from

Read the thread · 2026-04-05 · open · outside contributor · 2 comments

Fatal crash on Windows: "Circular reference detected" when Claude Code calls ListToolsRequest

Description

The MCP server crashes with a fatal ValueError: Circular reference detected (id repeated) when Claude Code sends a ListToolsRequest. The server starts, connects, and processes the initialize handshake successfully, but crashes during tool list serialization. This prevents any MCP tools from being used — Claude Code falls back to direct SSH.

Environment

  • OS: Windows 11 Enterprise (Build 22631)
  • Hardware: Dell Pro Max 16 MC16250 (Intel Core Ultra 7 265H, 16 cor

Read the thread · 2026-04-04 · closed · external user · 8 comments

Bug: asyncssh DNS resolution fails in container while system resolver works

Bug: asyncssh DNS resolution fails in container while system resolver works

Component

linux-mcp-server container image (quay.io/redhat-services-prod/rhel-lightspeed-tenant/linux-mcp-server:latest)

Version

  • linux-mcp-server: linux-diagnostics v2.14.5
  • asyncssh: 2.22.0
  • Container base: Python 3.12 (UBI)
  • Host: RHEL 10.1 (awa.3d.ae.net.nz), podman 5.6.0, kernel 6.12

Summary

All tools fail with [Errno -2] Name or service not known when using the host parameter for remote SSH

Read the thread · 2026-03-14 · open · external user · 2 comments

Schema warnings in OpenCode

After installing the MCP in OpenCode, I get warnings related to the tool schemas using "format": "path" which isn't part of the JSON Schema standard that opencode validates against.

Image

Read the thread · 2026-03-11 · open · external user · 3 comments

Commandline args don't work as expected

Hello,

It looks like none of the commandline arguments work as documented. I tried --help, -h and others.

Can you kindly advise what I'm doing wrong?

$ linux-mcp-server --help
2026-02-09 12:24:12 | INFO | root | Logging initialized: /home/user/.local/share/linux-mcp-server/logs
2026-02-09 12:24:12 | INFO | linux-mcp-server | Running Linux MCP Server 1.2.1. Press Ctrl+C, Enter to stop the server.
[02/09/26 12:24:12] INFO     Starting MCP server 'linux-diagnostics' with transport '

[Read the thread](https://github.com/rhel-lightspeed/linux-mcp-server/issues/265) · 2026-02-09 · closed · external user · 2 comments

### LINUX_MCP_LOG_LEVEL is having a wrong description in the community registry

Looking at https://registry.modelcontextprotocol.io/?q=linux-mcp-server I found out that the LINUX_MCP_LOG_LEVEL is having "Path to SSH private key" for description

<img width="353" height="336" alt="Image" src="https://github.com/user-attachments/assets/52dbdbc9-eb25-44ba-a6fc-aa10528e06ed" />

[Read the thread](https://github.com/rhel-lightspeed/linux-mcp-server/issues/222) · 2026-01-20 · closed · external user · 1 comment

### [RFE] - Add `instructions` to FastMCP Instantiation

## Summary

Request to add support for providing instructions during server instantiation, allowing clients to understand the server’s purpose and available functionality.

## Why it matters

When a tool-using agent (such as Claude Desktop or a custom MCP client) connects to a FastMCP server, it retrieves metadata describing the available tools, resources and server context. Many MCP clients choose to incorporate the server’s instructions into system-level context provided to the LLM when decidi

[Read the thread](https://github.com/rhel-lightspeed/linux-mcp-server/issues/191) · 2026-01-13 · closed · external user · 2 comments

### [RFE] Add the ability to remotely connect to the MCP server

I was wondering how much development it would be to add the feature for the mcp server to be be able to be accessed over http / https like you can with other MCP tools like FastMCP. The Idea is to host the MCP servers as a container or on their own system then have the AI agent on something like N8N connect to the MCP server remotely to access the tools.

I am open to discussing this more and helping provide PR's as need but wanted to see if this is something worth doing.

[Read the thread](https://github.com/rhel-lightspeed/linux-mcp-server/issues/176) · 2026-01-07 · closed · external user · 5 comments

## Most recent

### Wrong @field_serializer return type emits non-standard "path" format in JSON Schema

**Describe the bug**
The `@field_serializer("unit", "path")` in `linux_mcp_server/models.py` has return type `str | Path | None`, but the serializer always returns `str | None` (never a `Path` object). This causes Pydantic's serialization JSON schema to emit `"format": "path"` (a non-standard JSON Schema format) for **both** fields, including `unit$. Any MCP client that validates tool output schemas sees warnings like:

unknown format "path" ignored in schema at path "#/properties/unit/anyOf

Read the thread · 2026-05-12 · open · external user · 0 comments

unknown format "path" ignored in schema at path "#/properties/unit/anyOf/1"

Setting up an mcp server on Ubuntu using opencode.

$ cat /etc/lsb-release 
DISTRIB_ID=Ubuntu
DISTRIB_RELEASE=24.04
DISTRIB_CODENAME=noble
DISTRIB_DESCRIPTION="Ubuntu 24.04.4 LTS"

$ opencode --version
1.14.29

$ cat .config/opencode/opencode.json
[...]
    },
    "linux-mcp-server": {
      "type": "local",
      "command": [
        "/home/syangsao/.local/bin/linux-mcp-server"
      ]
    }

Steps to reproduce:

  1. Installed following the uv [method](https://rhel-lightspeed.github.i

Read the thread · 2026-04-29 · closed · external user · 0 comments

HTTP transport: Avoid requesting sudo password in the terminal

Description

When running the MCP server over HTTP transport, _wrap_script() request the sudo password in the terminal.

Environment

Fedora Linux, running the MCP server with the following environment variables:

  • LINUX_MCP_TRANSPORT: "http",
  • LINUX_MCP_HOST: "127.0.0.1",
  • LINUX_MCP_PORT: "8000",
  • LINUX_MCP_PATH: "/mcp",
  • LINUX_MCP_TOOLSET: "run_script",
  • LINUX_MCP_GATEKEEPER_MODEL:
  • VERTEXAI_PROJECT: ,
  • VERTEXAI_LOCATION:

Steps to reproduce

Read the thread · 2026-04-17 · closed · outside contributor · 0 comments

Automate the retrieval of TF artifacts back into the GitHub Actions workspace

Currently, functional test workflow displays only external artifact URLs to find the actial failure, and results.xml is not retrieved. Perhaps it can be solved via TF API or sclorg/testing-farm-as-github-action.

Read the thread · 2026-04-16 · open · outside contributor · 0 comments

[research] Consider replacing custom/API CI authorization with GitHub Environments

Background: Currently, the functional-tests.yml workflow uses the gh api to verify repository permissions (when #409 is merged) and to check if the user is authorized to run tests on TF.

Alternative: GitHub Actions has a native feature called Environments designed specifically for gating deployments or infrastructure usage. Perhaps, we can create an environment named Testing-Farm in the reposi

Read the thread · 2026-04-16 · open · outside contributor · 0 comments

Missing dependency when running the gatekeeper model with Vertex AI

Description

Using Vertex AI for the gatekeeper model fails due to missing dependency google-cloud-aiplatform.

Environment

Goose desktop 1.29.1 with Linux MCP extension configured with the following options:

  • Extension name: Linux MCP
  • Type: STDIO
  • Command: uv run --directory /home/jexposit/Devel/linux-mcp-server src/linux_mcp_server
  • Timeout: 300

Environment Variables:

  • LINUX_MCP_GATEKEEPER_MODEL: vertex_ai/claude-sonnet-4-6
  • LINUX_MCP_TOOLSET: run_script
  • VERTEXAI_PR

Read the thread · 2026-04-10 · closed · outside contributor · 0 comments

Refactor functional test dependency management

In addition to PR #328, consolidate functional test dependencies from tests/functional/requirements.txt into pyproject.toml, e.g. under a functional dependency group. Explore using uv within the plans/main.fmf to manage isolated environments on the target system, removing manual version maintenance while ensuring environment consistency.

Read the thread · 2026-04-09 · open · outside contributor · 1 comment

Query package dnf/rpm info?

Thanks for your amazing work so far 🎉

Am I right, that there is no tool to query the installed package version for a given package or get a list of installed packages (maybe with a glob)?

Are there tools planned to enable this?

Read the thread · 2026-03-31 · open · external user · 0 comments

When asking memory details only shows system memory details and not hardware's details.

By asking details of the memory at the hardware level it only shows the memory available at the system level. It ran "Get Memory Information in linux-mcp-server" It ran "Read File in linux-mcp-server" (/proc/meminfo) And it shows 1.67GiB or 1.79GB, and the VM has 2G assigned (kvm) If I run "dmidecode --type memory" manually I get the proper details.

Read the thread · 2026-03-18 · open · external user · 0 comments

linux-mcp-server is vunerable when attacking using Man in The Middle approach

The linux-mcp-server is vulnerable to Man-in-the-Middle (MITM) attacks due to disabled SSH host key verification in the default configuration.

How to reproduce:

 Generate SSH key
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ""

 Configure local SSH
cat ~/.ssh/id_ed25519.pub >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

 Test SSH works
ssh -o BatchMode=yes -o StrictHostKeyChecking=no localhost "echo 'SSH OK'"
  1. Verify Vulnerable Configuration
grep

[Read the thread](https://github.com/rhel-lightspeed/linux-mcp-server/issues/304) · 2026-03-15 · closed · outside contributor · 1 comment

### Docker setup configuration

Hey!

The Podman/Docker getting started does specify anything appart from the image source.

More information about volumes/mounts, `userns_mode` and other configuration should be clarified because at this time it feels like getting the image to run needs some reverse-engineering.

Thanks in advance!

[Read the thread](https://github.com/rhel-lightspeed/linux-mcp-server/issues/227) · 2026-01-22 · closed · external user · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/rhel-lightspeed/linux-mcp-server/issues).