# getmcp

> Universal installer and configuration tool for MCP (Model Context Protocol) servers across all AI applications.

## What is getmcp?

getmcp solves the MCP configuration fragmentation problem. Every AI application (Claude Desktop, VS Code, Cursor, Goose, Windsurf, Zed, etc.) uses a different config format for MCP servers — different root keys, field names, file formats, and conventions. getmcp defines a single canonical format, then uses generators to transform it into each app's native format.

## Key Features

- **19 supported AI applications**: Claude Desktop, Claude Code, VS Code, Cursor, Cline, Roo Code, Goose, Windsurf, OpenCode, Zed, PyCharm, Codex, Gemini CLI, Continue, Amazon Q, Trae, BoltAI, LibreChat, Antigravity
- **2,946+ MCP server registry**: Pre-configured definitions for popular MCP servers
- **4 config formats**: JSON, JSONC, YAML, TOML — auto-detected from file extension
- **CLI tool**: `npx @getmcp/cli add github` — auto-detects apps, prompts for env vars, merges configs
- **Library-first**: Use `@getmcp/generators`, `@getmcp/registry`, or `@getmcp/core` as npm packages
- **No runtime dependency**: Generates static config files, no proxy or daemon
- **MIT licensed**: No vendor lock-in

## Architecture

TypeScript monorepo with 5 packages:
- `@getmcp/core` — Zod schemas, TypeScript types, utility functions
- `@getmcp/generators` — Config generators for 19 AI applications
- `@getmcp/registry` — Registry of 2,946+ MCP server definitions
- `@getmcp/cli` — CLI tool with add, remove, list, find, check, update, doctor, import, registry, sync commands
- `@getmcp/web` — Next.js web directory at getmcp.es

## Quick Start

```bash
npx @getmcp/cli add github          # Install GitHub MCP server
npx @getmcp/cli list                # Browse all servers
npx @getmcp/cli list --search=database  # Search servers
npx @getmcp/cli doctor              # Health diagnostics
```

## Links

- Website: https://getmcp.es
- Repository: https://github.com/RodrigoTomeES/getmcp
- npm: https://www.npmjs.com/package/@getmcp/cli
