Linux MCP daemon (mcpd) — Claude Code MCP server: install
Connect an AI agent to Linux tools for inspecting system health and managing services without an SSH shell. Root access is controlled per tool.
Open on GitHubWhat Linux MCP daemon (mcpd) does
The server gives an agent structured tools for checking processes, memory, disks, logs, network connections and services. It communicates over HTTPS using SSE, with TLS enabled by default and a self-signed certificate created on first start.
Each tool call runs in a separate worker process under a Linux account. Rules in mcp-sudo.yaml determine which users and tools can receive elevated privileges. Calls are logged, with secrets redacted from arguments. Root is granted per tool, so broad permissions need careful configuration.
The daemon can run on a host, in Docker or in Kubernetes. To connect Claude Code, register the server’s SSE endpoint on port 9091 using the command below.
What it helps with
- inspect CPU load and memory use
- find disk usage on a Linux host
- review system logs and network connections
- check which Linux services are running
- grant root privileges to selected tools
Example prompts for the agent
- Check processes, memory, and disk use on my Linux server.
- Show the server's logs and network connections.
- Check the running services and restart the requested one if its permissions allow it.
How to install Linux MCP daemon (mcpd)
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport sse linux-mcp-daemon-mcpd https://{host}:9091/sseCodex
Codex connects MCP servers over stdio and streamable HTTP only, and this server speaks SSE
1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"linux-mcp-daemon-mcpd": {
"url": "https://{host}:9091/sse"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"linux-mcp-daemon-mcpd": {
"type": "sse",
"url": "https://{host}:9091/sse"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t sse linux-mcp-daemon-mcpd https://{host}:9091/sseStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Linux MCP daemon (mcpd)
How do I install Linux MCP daemon (mcpd) in Claude Code?
Run claude mcp add --transport sse linux-mcp-daemon-mcpd https://{host}:9091/sse. Replace {host} with your server address.
What does Linux MCP daemon (mcpd) do?
It connects an AI agent to tools for inspecting and managing a Linux system. The agent can access structured information about processes, disks, logs and services without using an SSH shell.
How does mcpd control root access?
A separate worker runs for each call under an OS account. Rules in mcp-sudo.yaml define which users and tools can receive elevated privileges.
