What is Podman Desktop Extension Mcp

The podman-desktop-extension-mcp is a comprehensive extension for Podman Desktop that implements the Model Context Protocol (MCP). It provides Linux users with a secure and efficient way to deploy and manage MCP servers using Podman’s container infrastructure.

Use cases

Use cases include deploying and managing AI-driven applications, facilitating secure data management, and providing a robust infrastructure for development and testing of containerized applications.

How to use

To use podman-desktop-extension-mcp, install it via Podman Desktop by navigating to Settings > Extensions and selecting ‘Install from Container Image’. Alternatively, you can build it from source using Node.js and pnpm.

Key features

Key features include server management capabilities (start/stop servers, monitor health), MCP client integration (AI assistant interaction, file system integration), and robust security features (rootless execution, resource isolation, encrypted communication).

Where to use

podman-desktop-extension-mcp is ideal for developers and system administrators who need to manage MCP servers in a secure and efficient manner, particularly in Linux environments.

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