Skip to main content
Glama

Aptly MCP Server

smithery badge

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:

npx -y @smithery/cli install @rashidazarang/aptly-mcp --client claude

Manual Installation

cd aptly-mcp npm install npm run build

Configuration

Environment Variables

export APTLY_API_URL=http://localhost:8080 # Default Aptly API endpoint export APTLY_AUTH_TOKEN=your_token_here # Optional authentication token

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{ "mcpServers": { "aptly": { "command": "node", "args": ["/path/to/aptly-mcp/build/index.js"], "env": { "APTLY_API_URL": "http://localhost:8080" } } } }

Remote Aptly Server

For remote Aptly servers with authentication:

{ "mcpServers": { "aptly": { "command": "node", "args": ["/path/to/aptly-mcp/build/index.js"], "env": { "APTLY_API_URL": "https://aptly.example.com", "APTLY_AUTH_TOKEN": "your-auth-token" } } } }

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

npm run build

Testing

npm run inspector # Launch MCP inspector for testing

Watching for Changes

npm run watch

API Documentation

The server connects to Aptly's REST API. Ensure your Aptly instance is running with API enabled:

aptly api serve -listen=":8080"

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

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    A 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
  • -
    security
    F
    license
    -
    quality
    Provides 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
  • A
    security
    F
    license
    A
    quality
    Connects AI assistants to GitLab, allowing users to manage merge requests, view reviews, and interact with discussions through natural language queries.
    Last updated -
    12
    15
    • Apple
    • Linux
  • A
    security
    F
    license
    A
    quality
    Enables 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

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rashidazarang/aptly-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server