About Linux System MCP SSE Server
A lightweight server for Ubuntu 22.04+ that makes system telemetry, logs, and network details available to compatible MCP clients over SSE. It is intended for system inspection on trusted local networks or through a secure VPN.
Key features
- 01CPU, memory, uptime, and process details
- 02Reads journalctl and custom logs
- 03Reports IPs, interfaces, and ports
- 04SSE connection for MCP clients
Use cases
- 01Check Linux host resource and process status
- 02Inspect system logs
- 03Review network addresses and listening ports
MCP support
Exposes Linux system information, logs, and network details to MCP clients over SSE. The README warns that HTTPS is unsupported and recommends trusted local networks or a secure VPN.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
mcp_server_urlclaude mcp add --transport http linux-system mcp_server_url{"mcpServers":{"linux-system":{"type":"http","url":"mcp_server_url"}}}Open in Cursor{"servers":{"linux-system":{"type":"http","url":"mcp_server_url"}}}Open in VS Code{"mcpServers":{"linux-system":{"type":"http","url":"mcp_server_url"}}}{"mcpServers":{"linux-system":{"serverUrl":"mcp_server_url"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README🖥️ Linux System MCP SSE Server
The aimiox Linux System MCP SSE Server is a lightweight agent for exposing system telemetry, logs, and network information via SSE. It's designed for Ubuntu 22.04+ and integrates seamlessly with the OpenAI Agents SDK or any compatible MCP client.
⚠️ Note: This server does not support HTTPS and is intended for use on trusted local networks or over a secure VPN connection.
✨ Features
✅ Zero-config startup on modern Ubuntu systems (22.04+)
📡 Exposes system info (CPU, memory, uptime, processes, etc.)
📁 Reads logs from journalctl or custom sources
🌐 Reports on IP addresses, interfaces, and ports
🤖 Compatible with OpenAI Assistant's MCPServerSse
🚀 Quick Start
Simply download mcp_ubuntu_system binary and run :
$ mcp_ubuntu_system
⚙️ Server Arguments
| Option | Env Variable | Default | Description |
|---|---|---|---|
--ip | MCP_LINUX_IP | 0.0.0.0 | IP to bind the server to |
--port | MCP_LINUX_PORT | 8003 | Port to listen on |
🧪 Test with CLI Client
To test the SSE server locally or remotely using the OpenAI Agents SDK, use the included linux_mcp_cli.py.
1. Set Your API Key
Create a .env file in the project root and add:
OPENAI_API_KEY=your-openai-key-here
2. Set the MCP Endpoint
Edit the following line in linux_mcp_cli.py:
MCP_LINUX_URL = "http://<mcp_ip_address>:<mcp_port>/sse"
Replace <mcp_ip_address> and <mcp_port> with your actual server values.
3. Run the Client
pip install openai-agents
python3 linux_mcp_cli.py
4. Interact with the Agent
The client will connect to the SSE server and allow you to chat with the Linux System Agent.
📞 Support
For questions, issues, or contributions, open an issue on github.com/aimiox/mcp, or email us
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.