@rashidazarang/aptly-mcp/smithery.json

Model Context Protocol server for Aptly package repository management - enables AI assistants to manage Debian repositories

{
  "schemaVersion": "0.1.0",
  "name": "@rashidazarang/aptly-mcp",
  "displayName": "Aptly MCP Server",
  "description": "Debian package repository management through Aptly with comprehensive tools for repositories, packages, snapshots, mirrors, and publishing",
  "author": {
    "name": "Rashid Azarang",
    "url": "https://github.com/rashidazarang"
  },
  "license": "MIT",
  "homepage": "https://github.com/rashidazarang/aptly-mcp",
  "repository": {
    "type": "git",
    "url": "https://github.com/rashidazarang/aptly-mcp.git"
  },
  "categories": [
    "Developer Tools",
    "System Administration",
    "Package Management"
  ],
  "tags": [
    "aptly",
    "debian",
    "ubuntu",
    "packages",
    "repository",
    "devops",
    "linux",
    "sysadmin"
  ],
  "serverConfig": {
    "command": "npx",
    "args": ["@rashidazarang/aptly-mcp"],
    "env": {
      "APTLY_API_URL": "http://localhost:8080"
    }
  },
  "tools": [
    {
      "name": "aptly_health_check",
      "description": "Check Aptly server health and connectivity",
      "category": "system"
    },
    {
      "name": "aptly_create_repo",
      "description": "Create new local Debian package repositories",
      "category": "repository"
    },
    {
      "name": "aptly_list_repos",
      "description": "List all repositories with filtering and search capabilities",
      "category": "repository"
    },
    {
      "name": "aptly_get_repo",
      "description": "Get detailed information about a specific repository",
      "category": "repository"
    },
    {
      "name": "aptly_delete_repo",
      "description": "Delete repositories with safety checks",
      "category": "repository"
    },
    {
      "name": "aptly_add_packages",
      "description": "Add packages to repositories from uploaded files",
      "category": "package"
    },
    {
      "name": "aptly_list_packages",
      "description": "List packages in repositories with search and filtering",
      "category": "package"
    },
    {
      "name": "aptly_search_packages",
      "description": "Search packages across all repositories",
      "category": "package"
    },
    {
      "name": "aptly_remove_packages",
      "description": "Remove packages from repositories",
      "category": "package"
    },
    {
      "name": "aptly_create_snapshot",
      "description": "Create snapshots from repositories or merge existing snapshots",
      "category": "snapshot"
    },
    {
      "name": "aptly_list_snapshots",
      "description": "List all available snapshots with metadata",
      "category": "snapshot"
    },
    {
      "name": "aptly_delete_snapshot",
      "description": "Delete snapshots with dependency checking",
      "category": "snapshot"
    },
    {
      "name": "aptly_create_mirror",
      "description": "Create mirrors of remote Debian repositories",
      "category": "mirror"
    },
    {
      "name": "aptly_list_mirrors",
      "description": "List all configured mirrors with status",
      "category": "mirror"
    },
    {
      "name": "aptly_update_mirror",
      "description": "Update mirrors to fetch latest packages",
      "category": "mirror"
    },
    {
      "name": "aptly_publish_repo",
      "description": "Publish repositories for APT client consumption",
      "category": "publish"
    },
    {
      "name": "aptly_publish_snapshot",
      "description": "Publish snapshots to stable distributions",
      "category": "publish"
    },
    {
      "name": "aptly_list_published",
      "description": "List all published repositories and endpoints",
      "category": "publish"
    },
    {
      "name": "aptly_upload_files",
      "description": "Upload package files to Aptly server",
      "category": "upload"
    }
  ],
  "resources": [
    {
      "name": "repositories",
      "description": "Dynamic listing of all repositories with package counts and metadata"
    },
    {
      "name": "packages",
      "description": "Searchable package database across all repositories"
    },
    {
      "name": "mirrors",
      "description": "Status and configuration of remote repository mirrors"
    },
    {
      "name": "snapshots",
      "description": "Available snapshots with creation dates and source information"
    },
    {
      "name": "published",
      "description": "Published repository endpoints and distribution information"
    }
  ],
  "examples": [
    {
      "title": "Create Repository",
      "description": "Create a new repository for web packages",
      "tool": "aptly_create_repo",
      "parameters": {
        "name": "web-packages",
        "comment": "Repository for web development packages",
        "defaultDistribution": "stable",
        "defaultComponent": "main"
      }
    },
    {
      "title": "Publish Repository",
      "description": "Publish repository to stable distribution",
      "tool": "aptly_publish_repo",
      "parameters": {
        "sourceKind": "local",
        "name": "web-packages",
        "prefix": "main",
        "distribution": "stable"
      }
    },
    {
      "title": "Create Snapshot",
      "description": "Create backup snapshot of production repository",
      "tool": "aptly_create_snapshot",
      "parameters": {
        "name": "prod-backup-2024",
        "sourceType": "repository",
        "sources": ["production-packages"],
        "description": "Production backup snapshot"
      }
    }
  ],
  "prerequisites": [
    {
      "name": "Aptly Server",
      "description": "Running Aptly API server",
      "command": "aptly api serve -listen=\":8080\"",
      "documentation": "https://www.aptly.info/doc/api/"
    }
  ]
}