Prepare the server locally
Run this once before adding it to Claude Code.
git clone https://github.com/arttttt/kernel-build-mcp
cd kernel-build-mcpThen follow the repository README for any remaining dependency or build steps.
Register it in Claude Code
claude mcp add kernel-build -- node /path/to/kernel-build-mcp/index.jsReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
kernel-build's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- 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
Tools 11
get_configShow current configurationset_configUpdate configuration remotelygit_pullFetch and pull latest changesgit_resetHard reset to remote statebuildFull kernel buildbuild_moduleBuild specific module directorymake_defconfigApply defconfigcleanClean build artifactsget_build_logRead last build logget_artifactDownload build artifact (base64)run_commandRun arbitrary command in kernel dirTry it
Original README from arttttt/kernel-build-mcp
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 [email protected]
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 |