Skip to main content
Glama
Linux MCP Server

Linux MCP Server

by algony-tony

Linux MCP Server

CI Go Coverage Recorder Coverage Mutation Score License

A high-performance, secure Go MCP (Model Context Protocol) server that exposes Linux system control to AI clients (Claude Desktop, Claude Code, Cursor, Gemini CLI, etc.) over Streamable HTTP with Bearer token authentication.

The core server mymcp is a single static Go binary. An optional Python sidecar daemon (mymcp-recorder) continuously maintains a live LLM-generated host overview.


Quick Install

Downloads the static binary, runs an interactive configuration wizard, and configures the systemd service:

curl -fsSL https://github.com/algony-tony/mymcp/releases/latest/download/install.sh | sudo bash

2. Via pipx

pipx install algony-mymcp
sudo mymcp init

mymcp init prompts for listening port, admin token, and creates /etc/mymcp/.env along with the systemd service. Add --yes to accept all defaults automatically.

3. Air-Gapped / Offline Install

Download mymcp-<version>-offline-bundle.tar.gz from GitHub Releases:

tar xzf mymcp-*-offline-bundle.tar.gz
cd mymcp-*-offline-bundle
sudo ./install-offline.sh

To upgrade: pipx upgrade algony-mymcp && sudo systemctl restart mymcp.


Related MCP server: mcp-remote-agent

Connecting Clients

Configure your MCP client (Claude Desktop, Cursor, or any Streamable HTTP MCP client) using standard Streamable HTTP transport:

{
  "mcpServers": {
    "linux-server": {
      "type": "streamableHttp",
      "url": "http://your-server:8765/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

MCP Tools Overview

algony-mymcp provides 9 dedicated tools. Tools accessible to a client depend on its token role:

Tool

Role

Description

bash_execute

rw

Execute shell commands in a stateless subprocess

read_file

ro

Read files with line numbering, offset, and limit pagination

write_file

rw

Atomically create or overwrite files (auto-creates directories)

edit_file

rw

Precise string replacement in existing files

glob

ro

Find matching file paths by glob pattern, sorted by mtime

grep

ro

Search file contents with regex (uses ripgrep with Go RE2 fallback)

prepare_upload

rw

Mint signed one-time URL for streaming binary/large file uploads

prepare_download

ro

Mint signed one-time URL for streaming file downloads

server_overview

ro

Retrieve live host status maintained by the recorder sidecar

πŸ‘‰ Full Schema & Examples: See MCP Tools Reference for detailed JSON parameters, return structures, and curl transfer examples.


Configuration

The server reads configuration from /etc/mymcp/.env (or environment variables). All options, default values, and explanations are documented directly inside .env.example.


Documentation Index


License

Apache License 2.0. See LICENSE for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers