convez.ai
MCP ServerDevOps & InfraestruturaIntermediário
RodrigoTomeES

getmcp - Instalador Universal de MCP Servers

RodrigoTomeES/getmcp

Uma ferramenta, 19 apps, sem dependências de runtime. Configure MCP servers em todos os seus IDEs.

Ver no GitHub
BomPluginScore · de 0 a 100

Ferramenta de linha de comando que instala e configura MCP servers em 19 aplicações de IA diferentes (Claude Desktop, VS Code, Cursor, etc.) automaticamente. Abstrai as diferenças de formato de configuração (JSON, JSONC, YAML, TOML) e oferece um registry com 105+ servidores prontos para usar.

Instalação

$npx convez-ai RodrigoTomeES/getmcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
13
Forks
3
Acompanhando
1
Saúde
57%
Último commit
há 2 dias
Versão
v0.10.2
Issues abertas
9
Contribuidores
4

Casos de uso

  • Instalar o mesmo MCP server em múltiplas aplicações de IA com um único comando
  • Gerenciar servidores MCP sem lidar manualmente com diferentes formatos de configuração
  • Descobrir e listar servidores MCP disponíveis com busca integrada

Veredito

Solução pragmática que resolve um problema real do ecossistema MCP: a fragmentação de formatos de configuração. Local-first, sem dependências em runtime, com suporte amplo a apps. Ideal para desenvolvedores que usam múltiplas ferramentas de IA simultaneamente.

README

A tradução para o português deste README ainda está na fila.

The problem: Every AI app uses a different config format for MCP servers. Claude Desktop uses mcpServers, VS Code uses servers, Goose uses YAML with cmd/envs, Codex uses TOML with mcp_servers... there are 19 apps, 6 root keys, and 4 formats.

The solution: One canonical format, config generators for every app, a registry of 105+ servers, and a CLI that auto-detects your apps and writes the correct config.

Browse the full server catalog at getmcp.es

Quick Start

# Install the GitHub MCP server into all your detected AI apps
npx @getmcp/cli add github

# Browse available servers
npx @getmcp/cli list

# Search for database servers
npx @getmcp/cli list --search=database

# Remove a server
npx @getmcp/cli remove github

Note: If you run into issues with npx, try npx @getmcp/cli@latest — npx can cache stale versions, and v0.7.0 had a broken release.

Why getmcp?

FeaturegetmcpSmitherymcpm.sh
Supported apps191914
Registry servers105+100K+ (cloud)379
Runtime dependencyNone (write & done)Cloud proxyLocal proxy
Config formatsJSON, JSONC, YAML, TOMLJSON onlyJSON only
LicenseMITAGPLMIT
Library-first designYes (npm packages)NoNo
Multi-app installYes (one command)NoNo
Offline/local-firstYesNoPartial

How It Works

                      Canonical Format
                           |
    +----------+-----------+-----------+----------+
    |          |           |           |          |
 Claude     VS Code     Goose      Codex   + 15 more
 Desktop   (servers)   (YAML)     (TOML)     apps
(mcpServers)          (extensions)(mcp_servers)
  1. Server definitions are stored in a canonical format (aligned with the official MCP registry schema)
  2. Config generators transform the canonical format into each app's specific format
  3. The CLI auto-detects installed apps, prompts for env vars, and merges configs into existing files (never overwrites)

Supported Apps

AppRoot KeyFormat
Claude DesktopmcpServersJSON
Claude CodemcpServersJSON
VS Code / CopilotserversJSON
CursormcpServersJSON
ClinemcpServersJSON
Roo CodemcpServersJSON
GooseextensionsYAML
WindsurfmcpServersJSON
OpenCodemcpJSONC
Zedcontext_serversJSON
PyCharmmcpServersJSON
Codexmcp_serversTOML
Gemini CLImcpServersJSON
ContinuemcpServersJSON
Amazon QmcpServersJSON
TraemcpServersJSON
BoltAImcpServersJSON
LibreChatmcpServersYAML
AntigravitymcpServersJSON

Registry

105+ MCP servers included out of the box. Here are some highlights:

ServerTransportDescription
GitHubstdioRepository management, issues, PRs via GitHub API
FilesystemstdioSecure file operations with access controls
Brave SearchstdioWeb search via Brave Search API
MemorystdioKnowledge graph-based persistent memory
PlaywrightstdioBrowser automation, screenshots, and element interaction
PostgreSQLstdioRead-only database access and queries
FigmastdioRead Figma design files and provide layout info to AI agents
shadcn/uistdioBrowse and install shadcn components from AI
Context7remoteUp-to-date library documentation and code examples
SentryremoteError tracking and monitoring
SupabaseremoteQuery databases, manage projects, deploy Edge Functions
OpenAI DocsremoteSearch OpenAI developer documentation
FirecrawlstdioWeb scraping and search with JavaScript rendering
RepomixstdioPack entire repositories into a single AI-friendly file
n8nstdioBuild and manage n8n automation workflows from AI

Browse the full catalog at getmcp.es or from the CLI:

npx @getmcp/cli list

Packages

PackageDescriptionnpm
@getmcp/cliCLI tool for installing MCP serversnpm
@getmcp/coreZod schemas, types, and utilitiesnpm
@getmcp/generatorsConfig generators for 19 appsnpm
@getmcp/registryRegistry of 105+ MCP server definitionsnpm

Library Usage

Generate config for any app

import { generateConfig, generateAllConfigs } from "@getmcp/generators";

// Generate for a specific app
const config = generateConfig("goose", "github", {
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-github"],
  env: { GITHUB_TOKEN: "ghp_xxx" },
});
// => { extensions: { github: { cmd: "npx", args: [...], envs: {...} } } }

// Generate for ALL apps at once
const all = generateAllConfigs("github", {
  command: "npx",
  args: ["-y", "@modelcontextprotocol/server-github"],
  env: { GITHUB_TOKEN: "ghp_xxx" },
});
// all["claude-desktop"] => JSON string
// all["goose"]          => YAML string
// all["codex"]          => TOML string

Validate configs with Zod schemas

import { StdioServerConfig, CanonicalMCPConfig } from "@getmcp/core";

StdioServerConfig.parse({ command: "npx", args: ["server"] });
// throws ZodError if invalid

Search the registry

import { searchServers, getServersByCategory } from "@getmcp/registry";

searchServers("database"); // [{ id: "postgres", ... }]
getServersByCategory("web"); // [{ id: "brave-search", ... }, { id: "fetch", ... }]

Development

# Install dependencies
npm install

# Build all packages
npm run build

# Run all tests (515 tests)
npm run test

# Build and test a specific package
npm run build --workspace=@getmcp/core
npm run test --workspace=@getmcp/core

# Run the CLI locally (no build needed)
npx tsx packages/cli/src/bin.ts add
npx tsx packages/cli/src/bin.ts list --search=database

# Run the web directory locally
npm run website

Architecture

getmcp/
  packages/
    core/          # Zod schemas, TS types, utility functions
    generators/    # 19 config generators (one per app)
    registry/      # 105+ MCP server definitions
    cli/           # add/remove/list/doctor/import commands, app detection
    web/           # Next.js web directory at getmcp.es

The CLI supports JSON, JSONC, YAML, and TOML config files natively. Format is auto-detected from the file extension, so Goose configs are read/written as YAML and Codex configs as TOML.

Contributing

See ROADMAP.md for planned improvements and open tasks. Contributions are welcome.

Credits

This CLI is inspired by vercel-labs/skills.

License

MIT

Ver o original no GitHub

Bom para

Relacionados