macos-setup
Complete macOS setup and teardown for MCP Gateway & Registry (AI-registry). Clones the repository, installs all services, configures Keycloak auth, registers the Cloudflare docs server, and verifies the full stack. Also supports complete teardown. Can be run directly from its GitHub URL without the repository already cloned. Uses an interactive or default-values mode chosen at startup.
npx skills add agentic-community/mcp-gateway-registry --skill macos-setup --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
It performs a complete macOS setup and teardown for MCP Gateway & Registry (AI-registry). It can be run directly from a GitHub URL without a pre-cloned repository. The setup clones the repository, installs and configures all services (Keycloak, registry, auth-server, MCP servers), builds Docker images from source, registers the Cloudflare docs server, and ends with a full summary of steps taken. Teardown removes all MCP Gateway components.
How it works
- On invocation, it starts with Step 0 to determine mode, requiring user input for operation (Setup or Teardown), execution mode, and installation directory. The first action is AskUserQuestion to gather 3 questions.
- Phase 1: Prerequisites Check runs checks for Docker, Python (via uv), uv, Node.js, git, jq, and gettext; provides install commands for any failures and stops if Docker or git fail. Python > 3.14 must be available via uv; otherwise Phase 5 will fail.
- Phase 2: Clone Repository clones agentic-community/mcp-gateway-registry into the chosen INSTALL_DIR if not present, or acknowledges existing repo and validates it. Changes into the directory and confirms essential files exist.
- Phase 3: Credentials Configuration auto-generates passwords in default mode or prompts in interactive mode. KEYCLOAK_ADMIN_PASSWORD and KEYCLOAK_DB_PASSWORD require at least 8 characters; generated values are stored for final summary.
- Phase 4: Environment File Setup creates or overwrites .env, generates SECRET_KEY and other tokens (DOCUMENTDB_PASSWORD, OPENBAO_TOKEN, GRAFANA_ADMIN_PASSWORD, INITIAL_ADMIN_PASSWORD), updates .env with specific keys, and ensures values exist for required variables used by docker-compose.yml. Updates are executed via a Python script embedded in the skill.
- After Phase 4, the environment file is updated and verified to contain required variables. The final phase (Phase 16) will report human-facing credentials: GRAFANA_ADMIN_PASSWORD and INITIAL_ADMIN_PASSWORD.
When to use it
- Use when you need a full macOS deployment of MCP Gateway & Registry from scratch, including building services from source and registering the Cloudflare docs server.
- Use teardown to remove all MCP Gateway components from the system.
What it can touch
- Executes commands from within the installation directory:
${INSTALL_DIR}. It references repository files and builds from source. It uses a GitHub URL to clone if needed. It documents the path to build_and_run.sh, docker-compose.yml, and .env.example as references.
Caveats
- The first action must be Step 0 with AskUserQuestion and three questions; no commands run before that.
- If prerequisites fail (Docker or git), the workflow stops and provides install instructions for fixes. If PYTHON_TOO_OLD is reported, user must run
uv python install 3.14and re-run the Python check. - Some steps depend on user input in Interactive mode; default mode uses sensible defaults and auto-generated passwords, with final summary reporting.
# MCP Gateway & Registry — macOS Setup Skill **Repository:** https://github.com/agentic-community/mcp-gateway-registry **This skill:** https://github.com/agentic-community/mcp-gateway-registry/blob/main/.claude/skills/macos-setup/SKILL.md **Full macOS guide:** https://github.com/agentic-community/mcp-gateway-registry/blob/main/docs/macos-setup-guide.md ## How to run this skill without cloning the repository This skill is self-contained. You can invoke it from any directory in Claude Code using the GitHub URL. It will clone the repository for you. ``` /macos-setup ``` Or reference it remotely if you have not installed this repo: ``` @https://raw.githubusercontent.com/agentic-community/mcp-gateway-registry/main/.claude/skills/macos-setup/SKILL.md ``` --- ## What this skill does **`/macos-setup setup`** — Full guided installation on a fresh macOS machine: - Clones the MCP Gateway & Registry repository - Installs and configures all services (Keycloak, registry, auth-server, MCP servers) - Builds all Docker images from source - Registers the Cloudflare Documentation MCP server so it appears immediately on login - Ends with a complete summary of every step taken **`/macos-setup teardown`
- How to run this skill without cloning the repository
- What this skill does
- CRITICAL: First action is ALWAYS Step 0
- Step tracking
- Step 0: Determine Mode — MUST BE FIRST, NO EXCEPTIONS
- SETUP WORKFLOW
- Phase 1: Prerequisites Check
- Phase 2: Clone Repository
- Phase 3: Credentials Configuration
- Phase 4: Environment File Setup
- Phase 5: Python Virtual Environment
- Phase 6: Download Embeddings Model
- Phase 7: Create Required Directories
- Phase 8: Start Keycloak Services
echo "Installation directory: ${INSTALL_DIR}"
echo "=== Docker ==="
docker --version 2>/dev/null && docker ps >/dev/null 2>&1 && echo "DOCKER_OK" || echo "DOCKER_FAIL"
echo "=== Python (>=3.14 required by pyproject.toml) ==="
Ask uv, not PATH. Phase 5 runs `uv sync`, which resolves its own managed
interpreters and ignores whatever `python3` happens to be first on PATH -- a
system python3 of 3.13 is fine as long as uv can see a >=3.14 somewhere.
Checking `python3 --version` instead reports a false failure on exactly the
machines where setup would have worked.
if uv python find '>=3.14' >/dev/null 2>&1; thenWhat does the macos-setup skill do?
Complete macOS setup and teardown for MCP Gateway & Registry (AI-registry). Clones the repository, installs all services, configures Keycloak auth, registers the Cloudflare docs server, and verifies the full stack. Also supports complete teardown. Can be run directly from its GitHub URL without the repository already cloned. Uses an interactive or default-values mode chosen at startup.
How do I install it?
Run `npx skills add agentic-community/mcp-gateway-registry --skill macos-setup --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From agentic-community/mcp-gateway-registry, a repository with 845 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.