Kernel Build MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
git clone https://github.com/arttttt/kernel-build-mcp
cd kernel-build-mcp

Then follow the repository README for any remaining dependency or build steps before continuing.

2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add kernel-build -- node "<FULL_PATH_TO_KERNEL_BUILD_MCP>/dist/index.js"

Replace <FULL_PATH_TO_KERNEL_BUILD_MCP>/dist/index.js with the actual folder you prepared in step 1.

README.md

MCP server for remote Linux kernel cross-compilation.

kernel-build-mcp

MCP server for remote Linux kernel cross-compilation.

Setup

1. Install Tailscale

Install on both Mac and Linux:

# Mac
brew install tailscale

# Linux
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

Enable Tailscale SSH on the Linux machine:

sudo tailscale up --ssh

Verify connectivity from Mac:

# Check Tailscale IP
tailscale ip -4   # on Linux machine

# Test SSH (no keys needed — Tailscale handles auth)
ssh user@100.x.x.x

Add to ~/.ssh/config for convenience:

Host kernel-build
    HostName 100.x.x.x
    User <user>

2. Deploy MCP server to Linux

scp -r . kernel-build:~/kernel-build-mcp/
ssh kernel-build "~/kernel-build-mcp/install.sh"

3. Configure

Either edit config on Linux directly:

ssh kernel-build "vi ~/.config/kernel-build-mcp/config.json"

Or use the set_config tool from Claude Code after connecting.

4. Connect from Claude Code

Copy .mcp.json to your kernel project:

cp .mcp.json /path/to/SmokeR24.1-kernel/.mcp.json

Or merge with existing .mcp.json if one exists.

Verify: claude --mcp-debug

Tools

Tool Description
get_config Show current configuration
set_config Update configuration remotely
git_pull Fetch and pull latest changes
git_reset Hard reset to remote state
build Full kernel build
build_module Build specific module directory
make_defconfig Apply defconfig
clean Clean build artifacts
get_build_log Read last build log
get_artifact Download build artifact (base64)
run_command Run arbitrary command in kernel dir

Tools (11)

get_configShow current configuration
set_configUpdate configuration remotely
git_pullFetch and pull latest changes
git_resetHard reset to remote state
buildFull kernel build
build_moduleBuild specific module directory
make_defconfigApply defconfig
cleanClean build artifacts
get_build_logRead last build log
get_artifactDownload build artifact (base64)
run_commandRun arbitrary command in kernel dir

Configuration

claude_desktop_config.json
{"mcpServers": {"kernel-build": {"command": "node", "args": ["/path/to/kernel-build-mcp/index.js"]}}}

Try it

Perform a full kernel build using the current configuration.
Fetch the latest changes from the remote repository and reset the state.
Build the specific module located in the drivers/net directory.
Retrieve the last build log to check for compilation errors.
Download the compiled kernel artifact as a base64 encoded file.

Frequently Asked Questions

What are the key features of Kernel Build MCP?

Remote Linux kernel cross-compilation over Tailscale SSH. Manage kernel build configurations remotely. Execute full builds or specific module builds. Retrieve build logs and download artifacts directly. Integrated Git management for kernel source control.

What can I use Kernel Build MCP for?

Cross-compiling Linux kernels on a powerful remote machine from a local development environment. Automating kernel module testing and build cycles via AI-assisted workflows. Managing kernel build configurations across multiple remote build nodes. Quickly debugging kernel build failures by accessing logs and artifacts through Claude.

How do I install Kernel Build MCP?

Install Kernel Build MCP by running: scp -r . kernel-build:~/kernel-build-mcp/ && ssh kernel-build "~/kernel-build-mcp/install.sh"

What MCP clients work with Kernel Build MCP?

Kernel Build MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Kernel Build MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare