macos-setup

Automate MCP Gateway & Registry setup and teardown on macOS.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/azeemigi/advent-2025 --skill macos-setup-azeemigi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-setup
Source: https://github.com/azeemigi/advent-2025/tree/main/.github/skills/.claude/skills/macos-setup
Command: npx skills add https://github.com/azeemigi/advent-2025 --skill macos-setup-azeemigi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the complex process of setting up a macOS environment for the MCP Gateway & Registry (AI-registry), ensuring all necessary services and configurations are in place for development and operation.

Core Features & Use Cases

  • Full Installation: Clones the repository, installs all services (Keycloak, registry, etc.), builds Docker images, and configures authentication.
  • Complete Teardown: Safely removes all installed components.
  • Flexible Operation: Supports both automated default setup and interactive, step-by-step configuration.
  • Use Case: A new team member can run this Skill on their macOS machine to get a fully functional AI-registry development environment within an hour, without needing to manually consult lengthy setup guides.

Quick Start

Run the macos-setup skill to perform a default installation of the AI-registry.

Frequently Asked Questions about macos-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the best way to configure the MCP Gateway and Registry development environment on macOS?

Yes, you can configure authentication for the AI-registry on macOS by running this Skill, which manages Keycloak setup and auth-server configuration automatically to establish a fully functional development environment.

Does the AI-registry macOS setup support interactive configuration?

Yes, the AI-registry macOS setup supports both automated default execution and interactive step-by-step configuration, allowing you to choose between a quick install or manual control over each service setup phase.

How do I safely teardown and remove the MCP Gateway and Registry from macOS?

To safely teardown and remove the MCP Gateway and Registry from macOS, run this Skill's teardown functionality, which completely removes all cloned repositories, installed services, and built Docker images.

Why does my macOS AI-registry installation fail during Docker image building?

macOS AI-registry installation failures during Docker image building are handled by this Skill's robust error handling and step tracking, which identifies service installation issues and guides configuration corrections.