The Aptly MCP Server enables AI assistants to manage Debian package repositories using Aptly through natural language commands, providing comprehensive control over package distribution.
Repository Management: Create, list, retrieve detailed information about, and delete local repositories with optional metadata like comments, components, and distributions.
Package Management: Add packages from uploaded files, list packages within repositories, and search for packages across all repositories.
File Upload Management: List uploaded files and delete uploaded files or directories from the server.
Snapshot Management: Create snapshots from repositories with optional descriptions and list existing snapshots.
Publishing: Publish repositories or snapshots to make them available for apt
consumption.
Mirror Management: Create mirrors of remote repositories, update mirrors to fetch latest packages, list configured mirrors, and get detailed mirror information.
Health Check: Verify the operational status and accessibility of the underlying Aptly server.
Provides tools for managing Debian package repositories using Aptly, including creating repositories, adding packages, creating snapshots, publishing repositories, and managing mirrors of remote Debian repositories.
Aptly MCP Server
A Model Context Protocol (MCP) server for managing Debian package repositories using the Aptly package repository management tool.
Overview
This MCP server provides AI assistants with direct access to Aptly functionality through standardized tools and resources. It enables natural language interaction with Debian package repositories, including creation, management, and publishing operations.
Features
MCP Tools
aptly_create_repo: Create new local repositories
aptly_list_repos: List all repositories with filtering options
aptly_add_packages: Add packages to repositories from uploaded files
aptly_search_packages: Search packages across repositories
aptly_create_snapshot: Create snapshots from repositories or other snapshots
aptly_publish_repo: Publish repositories/snapshots for apt consumption
aptly_create_mirror: Create mirrors of remote repositories
aptly_upload_files: Upload package files to the server
aptly_list_mirrors: List all configured mirrors
aptly_update_mirror: Update mirrors with latest packages
aptly_delete_repo: Delete repositories with safety checks
MCP Resources
repositories: Dynamic listing of all repositories with metadata
packages: Searchable package databases across repositories
mirrors: Remote mirror status and configuration
publications: Published repository information and endpoints
snapshots: Available snapshots with creation dates and descriptions
Installation
Installing via Smithery
To install aptly-mcp for Claude Desktop automatically via Smithery:
Manual Installation
Configuration
Environment Variables
Claude Desktop Configuration
Add to your claude_desktop_config.json
:
Remote Aptly Server
For remote Aptly servers with authentication:
Usage Examples
Once configured with Claude Desktop, you can use natural language commands:
Repository Management
"Create a new repository called 'production-packages' for production releases"
"List all repositories and show their package counts"
"Delete the 'test-repo' repository"
Package Operations
"Add all .deb files from the 'uploads' directory to the 'main' repository"
"Search for packages containing 'nginx' across all repositories"
"Remove the 'old-package' from the 'main' repository"
Snapshot Management
"Create a snapshot of the 'main' repository called 'v1.0-release'"
"List all snapshots and their creation dates"
"Create a merged snapshot from 'main' and 'contrib' repositories"
Publishing
"Publish the 'main' repository to the 'stable' distribution"
"Update the published 'testing' repository with the latest snapshot"
"List all published repositories and their endpoints"
Mirror Management
"Create a mirror of the Ubuntu main repository"
"Update all mirrors to get the latest packages"
"Show the status of the 'ubuntu-main' mirror"
Development
Building
Testing
Watching for Changes
API Documentation
The server connects to Aptly's REST API. Ensure your Aptly instance is running with API enabled:
Security Considerations
Use Unix domain sockets instead of network ports in production
Implement proper authentication for remote Aptly servers
Consider using a reverse proxy with HTTPS for production deployments
Validate all inputs to prevent injection attacks
License
MIT License
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Enables AI assistants to manage Debian package repositories through natural language using the Aptly package management tool. Supports repository creation, package operations, snapshot management, publishing, and mirror synchronization.
- Overview
- Features
- Installation
- Configuration
- Usage Examples
- Development
- API Documentation
- Security Considerations
- License
Related Resources
Related MCP Servers
- -securityFlicense-qualityA custom server implementation that allows AI assistants to interact with GitLab repositories, providing capabilities for searching, fetching files, creating/updating content, and managing issues and merge requests.Last updated -1
- -securityFlicense-qualityProvides GitLab integration for AI assistants using Model Context Protocol, enabling repository operations, file management, issue tracking, merge requests, and branch/tag administration through natural language.Last updated -2
- -securityFlicense-qualityConnects AI assistants to GitLab, allowing users to manage merge requests, view reviews, and interact with discussions through natural language queries.Last updated -9
- AsecurityFlicenseAqualityEnables AI assistants to manage development workflows by running build commands, executing tests, analyzing package.json files, installing dependencies, and performing code linting. Supports multiple package managers (npm, yarn, pnpm) and provides detailed error reporting for development operations.Last updated -5