Agent skill

MCP Installer

by lintendo in lintendo/Axhub-Skills

Install and configure MCP servers across desktop and CLI clients (Claude, Cline, Windsurf, Cursor, VSCode, Gemini CLI, Codex, Trae, Antigravity, etc.) on macOS/Windows/Linux, preferring…

MITAuto-check passedAgent Workflows

Install MCP Installer

skills CLI
$ npx skills add lintendo/Axhub-Skills --skill mcp-installer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lintendo/Axhub-Skills mcp-installer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lintendo/Axhub-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mcp-installer .claude/skills/mcp-installer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mcp-installer
GitHub stars
130
Token cost
~778 tokens
SKILL.md length
353 words
Files
2 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Install and configure MCP servers across desktop and CLI clients (Claude, Cline, Windsurf, Cursor, VSCode, Gemini CLI, Codex, Trae, Antigravity, etc.) on macOS/Windows/Linux, preferring…

  • Works in 5 steps: Collect inputs → Prefer @smithery/cli (when supported) → Manual install (JSON config fallback) → …
  • Tasks that involve MCP servers
  • SKILL.md covers Overview, Workflow and References
  • Calls npx

What it does

MCP Installer is an agent skill from lintendo/Axhub-Skills. Install and configure MCP servers across desktop and CLI clients (Claude, Cline, Windsurf, Cursor, VSCode, Gemini CLI, Codex, Trae, Antigravity, etc.) on macOS/Windows/Linux, preferring @smithery/cli when supported and otherwise performing manual JSON config updates and path discovery.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/clients.md`).

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol, macOS, Visual Studio Code and Linux. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers

Example prompts

  • “/mcp-installer”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Collect inputs
  2. Prefer @smithery/cli (when supported)
  3. Manual install (JSON config fallback)
  4. Verify and troubleshoot
  5. Trae deep-link fallback

What it can do on your machine

Read from SKILL.md and the folder at commit 1e1c5bc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MCP Installer loads about 778 tokens when it runs, and up to ~1.3k if it reads all its reference files. Until then it costs about 75 tokens; SKILL.md has 353 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~778
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from lintendo/Axhub-Skills at commit 1e1c5bc, republished under its MIT licence (© lintendo). 353 words, ~778 tokens.

Download SKILL.mdSave it as .claude/skills/mcp-installer/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
mcp-installer
description
Install and configure MCP servers across desktop and CLI clients (Claude, Cline, Windsurf, Cursor, VSCode, Gemini CLI, Codex, Trae, Antigravity, etc.) on macOS/Windows/Linux, preferring @smithery/cli when supported and otherwise performing manual JSON config updates and path discovery.

MCP Installer

Overview

Install MCP server configurations across multiple clients and OSes with a CLI-first workflow and a safe manual fallback.

Workflow

1) Collect inputs
  • Identify the target client ID and OS; use references/clients.md for the supported list and known paths.
  • Gather MCP server definitions (name -> config object) and decide whether to override existing entries.
  • If any provided MCP config includes secrets (for example fields like key, token, apiKey, accessToken, secret, password, or Authorization, or env vars like *_KEY, *_TOKEN), pause the install and ask the user to obtain/provide those values first. Only proceed once the user confirms they have the required credentials (or requests installing a placeholder and will fill it in later).
2) Prefer @smithery/cli (when supported)
  • Run npx @smithery/cli --help and npx @smithery/cli install --help to confirm the exact syntax.
  • Use the CLI install flow for the client ID; if the CLI rejects the client or fails, fall back to manual edits.
3) Manual install (JSON config fallback)
  • Locate the config file path (see references/clients.md). If unknown, search standard config dirs for files like mcp.json, mcp_config.json, claude_desktop_config.json, or cline_mcp_settings.json.
  • Read existing JSON and ensure a top-level mcpServers object exists.
  • Merge servers: add new names; replace existing when override is true; preserve all other keys.
  • Write JSON with 2-space indentation.

Example shape:

json
{
  "mcpServers": {
    "example-server": {
      "command": "npx",
      "args": ["-y", "example-mcp@latest"],
      "env": {}
    }
  }
}
Show full SKILL.md (139 more words)Show less
4) Verify and troubleshoot
  • Restart the client and confirm the MCP servers appear.
  • If writes fail on macOS, prompt for Full Disk Access and ensure the client app is closed before writing.
  • For CLI-only clients (for example claude-code), use the client CLI help to locate its MCP install/config command.
  • If Trae/Trae-CN installs fail due to permissions or other errors, generate a deep link and return it as a fallback.

If trae or trae-cn cannot write to disk, generate a schema link for the user to open in Trae:

  • trae: trae://trae.ai-ide/mcp-import?type=${TYPE}&name=${NAME}&config=${BASE64_ENCODED_CONFIG}
  • trae-cn: trae-cn://trae.ai-ide/mcp-import?type=${TYPE}&name=${NAME}&config=${BASE64_ENCODED_CONFIG}

Rules:

  • TYPE is the MCP transport type (for example streamable-http).
  • NAME is the server name shown in Trae.
  • config is the base64-encoded JSON config object for that server (no whitespace, UTF-8 bytes).

References

  • Use references/clients.md for client IDs, aliases, and known config paths.

© lintendo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/mcp-installer of lintendo/Axhub-Skills.

  • SKILL.md
  • references/clients.md

Open the folder on GitHubat commit 1e1c5bc

Compare with similar skills

MCP Installer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MCP Installer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MCP Installer this skilllintendo/Axhub-Skills130—~778Automated safety check: PassMIT
Cortex Mem MCPsopaco/cortex-mem313—~2.8kAutomated safety check: PassMIT
Mps Project ManagementJetBrains/MPS1.7k—~2.2kAutomated safety check: PassApache-2.0
Gearcoleco Romhackingdrhelius/Gearcoleco142—~3.9kAutomated safety check: PassGPL-3.0
Healthmd CLICodyBontecou/health-md231—~3.9kAutomated safety check: PassAGPL-3.0
Gearcoleco Debuggingdrhelius/Gearcoleco142—~3.5kAutomated safety check: PassGPL-3.0

Similar skills

  • Cortex Mem MCP

    sopaco/cortex-mem

    Persistent memory enhancement for AI agents. An agent skill from sopaco/cortex-mem.

    313 GitHub stars~2.8k tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • Official

    Open an MPS project in a running or freshly started MPS instance when MCP tools fail because no project is open (welcome screen), close an open project with mpsmcpcloseproject, or create a new empty…

    1.7k GitHub stars~2.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Gearcoleco Romhacking

    drhelius/Gearcoleco

    Hack, modify, and translate ColecoVision and Super Game Module ROMs using the Gearcoleco emulator MCP server.

    142 GitHub stars~3.9k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Healthmd CLI

    CodyBontecou/health-md

    Install and operate the standalone Health.md CLI and portable healthmd-mcp server on macOS, Linux, or Windows.

    231 GitHub stars~3.9k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Gearcoleco Debugging

    drhelius/Gearcoleco

    Debug and trace ColecoVision and Super Game Module games using the Gearcoleco emulator MCP server.

    142 GitHub stars~3.5k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Devsy

    devsy-org/devsy

    Operate Devsy workspaces and providers for end users. An agent skill from devsy-org/devsy.

    111 GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed

More from lintendo/Axhub-Skills

All 13 skills in this repo
  • React To Figma Make

    lintendo/Axhub-Skills

    A skill your agent uses when 需要把现有 React、Vite、Next.js、V0 或 AI Studio 页面转换为 Figma Make 可导入的 .fig 资产,或补齐、更新、验证已有 Figma Make 导出壳和 canvas.fig。

    130 GitHub stars~4.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Search Design System

    lintendo/Axhub-Skills

    A skill your agent uses when selecting an existing design system or theme for a product, page, prototype, or implementation through Axhub design knowledge indexes; not when creating or updating a…

    130 GitHub stars~643 tokensUpdated 1 mo ago
    Auto-check passed
  • Axhub Prototype Context

    lintendo/Axhub-Skills

    A skill your agent uses when an annotated prototype URL exposes PRD, directory, annotation, or source context that an AI Agent needs for review, implementation planning, production work, source…

    130 GitHub stars~684 tokensUpdated 1 mo ago
    Auto-check passed
  • Extract Axure Data

    lintendo/Axhub-Skills

    Extract structured data from Axure prototypes using Playwright — screenshots, design tokens, interaction maps, annotations, and page text.

    130 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings
  • Clone Page

    lintendo/Axhub-Skills

    高精度克隆网页。使用 Playwright 渐进式采集页面数据(DOM 结构、样式、截图、资源), 然后分阶段构建完整的 HTML/CSS 还原。支持快速还原和高精度还原两种模式。

    130 GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Extract Page Data

    lintendo/Axhub-Skills

    Extract structured data from any web page using Playwright — screenshots, design tokens, page text as Markdown, interactive element maps, and full page data packs.

    130 GitHub stars~2.7k tokensUpdated 1 mo ago
    Auto-check: warnings

Categories

Questions about MCP Installer

What does MCP Installer do?

Install and configure MCP servers across desktop and CLI clients (Claude, Cline, Windsurf, Cursor, VSCode, Gemini CLI, Codex, Trae, Antigravity, etc.) on macOS/Windows/Linux, preferring…. MCP Installer is an agent skill from lintendo/Axhub-Skills.) on macOS/Windows/Linux, preferring @smithery/cli when supported and otherwise performing manual JSON config updates and path discovery.

When should I use MCP Installer?

MCP Installer fits situations like: tasks that involve MCP servers.

How do I install MCP Installer in Claude Code?

Run `npx skills add lintendo/Axhub-Skills --skill mcp-installer -a claude-code`. Or copy the skill folder (skills/mcp-installer in lintendo/Axhub-Skills) into .claude/skills/mcp-installer in your project. Claude Code loads it when a task matches its description.

How do I install MCP Installer in Codex?

Run `npx skills add lintendo/Axhub-Skills --skill mcp-installer -a codex`. Or copy the skill folder (skills/mcp-installer in lintendo/Axhub-Skills) into .agents/skills/mcp-installer in your project. Codex loads it when a task matches its description.

Can I use MCP Installer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lintendo/Axhub-Skills --skill mcp-installer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp-installer, .gemini/skills/mcp-installer, .github/skills/mcp-installer and .opencode/skills/mcp-installer in your project.

What does MCP Installer need to run?

Going by SKILL.md and its folder, MCP Installer needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does MCP Installer access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is MCP Installer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MCP Installer use?

MCP Installer is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MCP Installer use?

About 778 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 507 tokens, read only when the agent opens those files.

What are the alternatives to MCP Installer?

Skills that share tags, products or a category with MCP Installer: Cortex Mem MCP (sopaco/cortex-mem, 313 stars), Mps Project Management (JetBrains/MPS, 1.7k stars), Gearcoleco Romhacking (drhelius/Gearcoleco, 142 stars) and Healthmd CLI (CodyBontecou/health-md, 231 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP Installer?

lintendo (a GitHub user) maintains it in lintendo/Axhub-Skills, which has 130 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on August 21, 2026.

Source: lintendo/Axhub-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.