Linux MCP Server

@MartinDai

Repository

Basic information

About Linux MCP Server

support execute shell on a remote linux or local machine

#linux-mcp-server#shell-execution#remote-command

Linux MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Linux MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is linux-mcp-server?

A Model Context Protocol (MCP) server built with Spring Boot and Spring AI that executes shell commands on local or remote Linux hosts. It exposes an executeShell tool via the MCP standard interface, allowing AI assistants like Claude Desktop to perform command-line operations securely.

How to use linux-mcp-server?

Ensure Java 17+ and Maven 3.6+ are installed.
Clone the repository and edit src/main/resources/hosts.json to configure remote host credentials (IP, username, password).
Start the server with mvn spring-boot:run or package it as a JAR (mvn clean package; java -jar target/linux-mcp-server-1.0.0.jar). The server listens on port 3001 at /mcp.
Add the server to an MCP client (e.g., Claude Desktop) using its HTTP endpoint. The client will discover the executeShell tool, which accepts machineIp (optional), path (optional), and shell (required) parameters.

Key features of linux-mcp-server

Dual execution mode: local process or remote SSH.
SSH connection pool managed with Caffeine (5‑minute idle expiry).
Lightweight host configuration via hosts.json.
Spring Boot native, runnable as mvn spring-boot:run or executable JAR.
MCP protocol compatible (STREAMABLE HTTP transport).

Use cases of linux-mcp-server

AI-powered server administration (e.g., restart services, check logs).
Automated batch command execution across multiple Linux hosts.
Integrating shell scripting capabilities into MCP‑compatible chatbots.

Frequently asked questions

What runtime does linux-mcp-server require?

Java 17+ and Maven 3.6+ (or the bundled Maven wrapper). The target hosts must have SSH service enabled.

How are remote host credentials handled?

Credentials are stored in plain text inside `hosts.json`. The README advises against committing production credentials; use environment variables or a secure config store for sensitive environments.

Does the server verify SSH host keys?

No. It uses `PromiscuousVerifier` which skips host key verification. For production, replace with a known‑hosts list to prevent man‑in‑the‑middle attacks.

What is the default transport and port?

The server uses STREAMABLE HTTP transport and listens on port `3001` at the `/mcp` endpoint. Both can be changed in `application.yml`.

How long are SSH connections cached?

SSH connections are cached by Caffeine with a default idle timeout of 5 minutes. The cache duration and maximum size can be adjusted in `RemoteShellService`.

Comments

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.