mcp-install

Installs and verifies the MCP orchestration stack including ai-cli-mcp and OpenClaw registry entries.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill mcp-install-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-install
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/mcp-install
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill mcp-install-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Setting up the MCP orchestration stack on a new machine involves many manual steps—installing ai-cli-mcp, registering servers in Claude Code and OpenClaw, optionally configuring Gemini, and verifying everything works. This Skill automates the entire process with an idempotent installer script that skips already-completed steps. ## Core Features & Use Cases - Idempotent Stack Installation: Runs install-mcp-stack.sh to install ai-cli-mcp, register MCP servers in Claude Code and OpenClaw, and sync Cursor MCP configs, skipping steps that are already complete. - Dry-Run and Force Modes: Preview every command with --dry-run before making changes, or re-run all steps with --force after a version pin change or silent failure. - Optional Gemini Analyzer Lane: Installs and authenticates gemini-cli only when --include-gemini is explicitly passed, keeping the default stack minimal. - Use Case: You just cloned the orama-system repo on a fresh laptop. Run the installer once, restart Claude Code, and confirm ai-cli-mcp appears as active in /mcp without manually editing any MCP JSON configs. ## Quick Start Run the installer with bash bin/orama-system/scripts/install-mcp-stack.sh, then restart Claude Code and verify with /mcp.

Frequently Asked Questions about mcp-install

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

FAQPage Schema
How do I install the MCP orchestration stack on a new machine?

Run bash bin/orama-system/scripts/install-mcp-stack.sh from the orama-system repo. The script installs ai-cli-mcp globally, registers it in Claude Code and OpenClaw, and prints a verification summary. Restart Claude Code afterward and check /mcp.

How do I preview MCP installer changes before running them?

Run the installer with the --dry-run flag. Every step prints [dry-run] followed by the command it would execute, without making any changes to the system or MCP registrations.

Is the MCP installer safe to run multiple times?

Yes, the installer is idempotent. Each step checks whether it is already complete—for example by checking if ai-cli is in PATH or grepping claude mcp list—and skips finished steps. Use --force to re-run everything.

Why is gemini-cli missing from /mcp after installation?

Gemini is opt-in and only installed when the --include-gemini flag is passed. If it was registered at project scope instead of user scope, re-run with --force so the script registers it with -s user.

What Node.js version does the MCP stack require?

Node.js 20 or higher is a hard requirement. The installer stops with a fatal error on older versions because the MCP servers hit ESM import errors on Node below 20.

How do I roll back the MCP stack installation?

Uninstall the global npm packages with npm uninstall -g @google/gemini-cli ai-cli-mcp, then remove registrations using claude mcp remove and openclaw mcp unset for each server name. The SKILL.md documents the full rollback command sequence.