podman-desktop-extension-mcp

MCP Server Manager Extension for Podman Desktop

A comprehensive Podman Desktop extension that implements the Model Context Protocol (MCP), providing Linux users and others with a complete alternative to Claude Desktop. This extension enables secure deployment and management of MCP servers using Podman's container infrastructure.

Overview

The MCP Server Manager extension leverages Podman Desktop's extension capabilities to deliver:

• Full MCP client and server implementation
• Secure container-based deployment
• Integrated AI assistant capabilities
• Native Linux support with enhanced security through Podman's rootless architecture

For detailed architecture and design information, see our Technical Documentation.

Core Features

• Server Management

  • Start/stop MCP servers with configurable options
  • Monitor server health and status
  • List and manage multiple server instances

• MCP Client Integration

  • Direct AI assistant interaction
  • File system integration for data management
  • Secure API key handling

• Security Features

  • Rootless container execution
  • Resource isolation
  • Access control enforcement
  • Encrypted communication

Quick Start

Requirements

• Podman Desktop >= 1.10.0
• Podman installed and configured
• For building from source:
  • Node.js >= 20.x
  • pnpm >= 8.x

Installation

There are two ways to install the extension:

Method 1: Install from Container Registry (Recommended)

1. Install the extension in Podman Desktop:
   • Open Podman Desktop
   • Go to Settings > Extensions
   • Click "Install from Container Image"
   • Enter: ghcr.io/sparesparrow/podman-desktop-extension-mcp:latest

Method 2: Build and Install from Source

1. Clone and setup:

git clone https://github.com/sparesparrow/podman-desktop-extension-mcp.git
cd podman-desktop-extension-mcp
pnpm install
pnpm run build

2. Install in Podman Desktop:
   • Open Podman Desktop
   • Go to Settings > Extensions
   • Click "Install from Directory"
   • Select the built extension directory

Documentation

• Architecture and Design - Detailed technical architecture
• Security Guide - Security features and best practices
• Development Guide - Guide for contributors
• API Reference - API documentation

Usage

Access these commands through Podman Desktop's command palette (Ctrl/Cmd + Shift + P):

• MCP: Start Server - Deploy new MCP server
• MCP: Stop Server - Stop running server
• MCP: Get Status - Check server status
• MCP: List Servers - View all servers

Default Configuration

{
  name: 'mcp-server',
  image: 'ghcr.io/sparesparrow/podman-desktop-extension-mcp:latest',
  version: 'latest',
  transport: {
    type: 'http-sse',
    port: 3000,
    host: 'localhost',
    basePath: '/api/v1'
  },
  capabilities: {
    resources: true,
    tools: true,
    prompts: true,
    logging: true
  },
  readinessProbe: {
    initialDelaySeconds: 5,
    periodSeconds: 10,
    failureThreshold: 3,
    httpGet: {
      path: '/health',
      port: 3000
    }
  }
}

Contributing

See our Development Guide for details on:

• Setting up the development environment
• Running tests
• Code style guidelines
• Contribution workflow

License

Apache-2.0 - see LICENSE for details.

Related Projects

• Model Context Protocol (MCP) Specification
• Podman Desktop
• MCP TypeScript SDK