feat: devpod-mcp — MCP server wrapping DevPod CLI

[aniongithub]

Summary

Rust MCP server (stdio) that gives AI coding agents full control over isolated DevPod development environments.

What's included

• 15 MCP tools — workspace lifecycle (up/stop/delete/build/status/list), command execution (ssh), provider/context management, logs, and direct Docker inspect/logs via bollard
• DevPod CLI wrapper (devpod-mcp-core) with JSON output parsing
• Devcontainer config — debian:bookworm-slim, Rust, Node, Docker-in-Docker, runs as vscode user
• CI workflow — cargo check/test/clippy/fmt on PR to main
• Release workflow — builds binaries for linux-x64, linux-arm64, darwin-x64, darwin-arm64 on GitHub release
• Install script — one-liner that auto-detects OS/arch, downloads the binary, installs DevPod CLI if missing, and deploys SKILL.md for agent discovery
• SKILL.md — agent instructions enforcing "if .devcontainer/ exists, use DevPod, never touch the host"

Architecture

graph TD
    A[AI Agent / MCP Client] -->|stdio JSON-RPC| B[devpod-mcp binary]
    subgraph "devpod-mcp"
        B --> C[15 MCP Tools]
        C --> D[devpod-mcp-core lib]
    end
    D -->|subprocess| E[DevPod CLI]
    D -->|bollard API| F[Docker Engine]
    E --> G[DevPod Workspace Container]
    F --> G

Loading

Quick install

curl -fsSL https://raw.githubusercontent.com/aniongithub/devpod-mcp/main/install.sh | bash

Tested

• Full lifecycle via MCP: status → stop → status (Stopped) → up → ssh → logs ✅
• Builds and tests pass inside DevPod workspace (debian:bookworm-slim, vscode user) ✅
• Binary runs on host (6MB, glibc compatible) ✅