{"_id":"@amritessh/mcp-hub","name":"@amritessh/mcp-hub","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@amritessh/mcp-hub","version":"0.1.0","description":"Community registry for MCP servers — install any MCP server into Claude Code with one command","main":"dist/index.js","bin":{"mcp-hub":"dist/index.js"},"scripts":{"build":"tsc -b","dev":"tsc -b --watch","start":"node dist/index.js"},"dependencies":{"commander":"^12.0.0"},"devDependencies":{"typescript":"^5.4.0"},"_id":"@amritessh/mcp-hub@0.1.0","gitHead":"524bd6b6ccb4df688a1ce30ec40fab65d4caf963","types":"./dist/index.d.ts","_nodeVersion":"20.18.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-Zs5QFmGzhsGID4Nkgx4UPU1TFRlO6gAzjzHhQzrsm4SfwYfRFWi3j7a5Fe+T7QFEz9jwLqSQKfql/hvYLL2nRQ==","shasum":"dfbdae5f67ab0936b99d325776b47c1b32d33c4c","tarball":"https://registry.npmjs.org/@amritessh/mcp-hub/-/mcp-hub-0.1.0.tgz","fileCount":15,"unpackedSize":40487,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICrPtgk338Pem4VVewIQaxABYYZIs5dD7Ti1SBwiwezdAiBlwpm40YBdCiuKA0NlJIABPWFQG1YQrCGVyGzuS1kk7g=="}]},"_npmUser":{"name":"amritessh","email":"amriteshanand7@gmail.com"},"directories":{},"maintainers":[{"name":"amritessh","email":"amriteshanand7@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-hub_0.1.0_1774908542566_0.4460375044115088"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-30T22:09:02.424Z","0.1.0":"2026-03-30T22:09:02.816Z","modified":"2026-03-30T22:09:03.086Z"},"maintainers":[{"name":"amritessh","email":"amriteshanand7@gmail.com"}],"description":"Community registry for MCP servers — install any MCP server into Claude Code with one command","readme":"# mcp-hub\n\n**The community registry for MCP servers. Install any MCP server into Claude Code with one command.**\n\n[![npm version](https://img.shields.io/npm/v/mcp-hub)](https://www.npmjs.com/package/mcp-hub)\n[![npm downloads](https://img.shields.io/npm/dm/mcp-hub)](https://www.npmjs.com/package/mcp-hub)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\n\n[MCP (Model Context Protocol)](https://modelcontextprotocol.io) servers extend Claude Code with new capabilities — query databases, search the web, interact with APIs, automate browsers, and more. But finding, configuring, and installing them is tedious.\n\n`mcp-hub` is the `npm` for MCP servers. Browse a curated registry, install with one command, and get back to building.\n\n![Demo](demo.gif)\n\n---\n\n## Why this exists\n\nClaude Code's real power comes from MCP servers — tools that let Claude interact with your actual systems. But the ecosystem is fragmented. Servers are scattered across GitHub, configs are manually written, and every developer reinvents the same setup steps.\n\n`mcp-hub` solves this with:\n- A **curated, community-maintained registry** of MCP servers\n- A **one-command installer** that handles `~/.claude/settings.json` for you\n- **No API key needed** — it's just a registry + a file editor\n\n---\n\n## Installation\n\n```bash\nnpx @amritessh/mcp-hub <command>              # run without installing\nnpm install -g @amritessh/mcp-hub             # or install globally\n```\n\nRequires Node.js 18+. No API keys needed.\n\n---\n\n## Usage\n\n### Browse all available servers\n\n```bash\nnpx @amritessh/mcp-hub list\n```\n\n```\nAvailable MCP servers (15):\n\n  [ ] mcp-server-postgres       Query and inspect PostgreSQL databases\n        tags: database, sql, postgres\n\n  [ ] mcp-server-github         Interact with GitHub — repos, issues, PRs\n        tags: github, git, vcs\n\n  [✓] mcp-server-slack          Read Slack channels, search messages, post replies\n        tags: slack, messaging, communication\n  ...\n\nInstall with: mcp-hub install <name>\n```\n\nThe `[✓]` mark shows servers you've already installed.\n\n### Search by keyword or tag\n\n```bash\nnpx @amritessh/mcp-hub search postgres\nnpx @amritessh/mcp-hub search database\nnpx @amritessh/mcp-hub search monitoring\n```\n\n### See full details about a server\n\n```bash\nnpx @amritessh/mcp-hub show mcp-server-github\n```\n\n```\nmcp-server-github\n  Interact with GitHub — search repos, read files, manage issues and PRs\n\n  Command:  npx -y @modelcontextprotocol/server-github\n  Env vars: GITHUB_TOKEN\n  Tags:     github, git, vcs\n  Homepage: https://github.com/modelcontextprotocol/servers/...\n\nInstall with: mcp-hub install mcp-server-github\n```\n\n### Install a server\n\n```bash\nnpx @amritessh/mcp-hub install mcp-server-postgres\n```\n\nIf the server requires environment variables, you'll be prompted:\n\n```\nmcp-server-postgres requires the following environment variables:\n  DATABASE_URL: postgresql://localhost:5432/mydb\n```\n\nThen it writes to `~/.claude/settings.json` (with a backup at `.bak`):\n\n```json\n{\n  \"mcpServers\": {\n    \"mcp-server-postgres\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@modelcontextprotocol/server-postgres\", \"postgresql://localhost:5432/mydb\"],\n      \"env\": {\n        \"DATABASE_URL\": \"postgresql://localhost:5432/mydb\"\n      }\n    }\n  }\n}\n```\n\n**Restart Claude Code** after installing for the server to take effect.\n\n### List installed servers\n\n```bash\nnpx @amritessh/mcp-hub list --installed\n```\n\n### Uninstall a server\n\n```bash\nnpx @amritessh/mcp-hub uninstall mcp-server-postgres\n```\n\n---\n\n## Commands\n\n| Command | Description |\n|---|---|\n| `mcp-hub list` | List all servers in the registry |\n| `mcp-hub list --installed` | List only your installed servers |\n| `mcp-hub search <query>` | Search by name, description, or tag |\n| `mcp-hub show <name>` | Show full details for a server |\n| `mcp-hub install <name>` | Install a server into Claude Code |\n| `mcp-hub uninstall <name>` | Remove a server from Claude Code |\n\n### Options\n\n| Flag | Description |\n|---|---|\n| `--registry <url>` | Use a custom registry URL instead of the default |\n\n---\n\n## Available servers\n\n| Server | Description | Tags |\n|---|---|---|\n| `mcp-server-postgres` | Query PostgreSQL databases | database, sql |\n| `mcp-server-sqlite` | Read/write SQLite databases | database, sql |\n| `mcp-server-filesystem` | Local filesystem access | filesystem |\n| `mcp-server-github` | GitHub repos, issues, PRs | github, git |\n| `mcp-server-gitlab` | GitLab repos, MRs, CI | gitlab, git |\n| `mcp-server-slack` | Read/post Slack messages | slack, messaging |\n| `mcp-server-brave-search` | Web search via Brave API | search, web |\n| `mcp-server-puppeteer` | Browser automation | browser, scraping |\n| `mcp-server-redis` | Read/write Redis | database, cache |\n| `mcp-server-linear` | Manage Linear issues | project-management |\n| `mcp-server-sentry` | Query Sentry errors | observability |\n| `mcp-server-aws` | AWS services (S3, Lambda…) | aws, cloud |\n| `mcp-server-notion` | Read/write Notion pages | docs |\n| `mcp-server-jira` | Manage Jira tickets | project-management |\n| `mcp-server-datadog` | Query metrics and logs | observability |\n\n---\n\n## How it works\n\n```\nRegistry (registry/servers.json in this repo, hosted on GitHub)\n  ↓\nCLI fetches registry from raw.githubusercontent.com (always fresh)\n  ↓ install\nPrompts for required env vars\n  ↓\nReads ~/.claude/settings.json\nCreates backup at ~/.claude/settings.json.bak\nAdds mcpServers entry\nWrites updated settings\n  ↓\nRestart Claude Code → server is active\n```\n\n**No backend.** The registry is a JSON file in this GitHub repo. No servers, no databases, no auth.\n\n**Always fresh.** The CLI fetches the registry from GitHub on every run, so newly added servers appear instantly without updating the CLI.\n\n**Safe installs.** Existing settings are backed up before any changes. If something goes wrong, restore with `cp ~/.claude/settings.json.bak ~/.claude/settings.json`.\n\n---\n\n## Adding your MCP server to the registry\n\nOpen a pull request adding an entry to `registry/servers.json`:\n\n```json\n{\n  \"name\": \"mcp-server-your-tool\",\n  \"description\": \"One sentence: what this server lets Claude do\",\n  \"command\": \"npx\",\n  \"args\": [\"-y\", \"your-npm-package\", \"$REQUIRED_ENV_VAR\"],\n  \"envVars\": [\"REQUIRED_ENV_VAR\"],\n  \"tags\": [\"relevant\", \"tags\"],\n  \"homepage\": \"https://github.com/you/your-mcp-server\"\n}\n```\n\n**Schema fields:**\n\n| Field | Required | Description |\n|---|---|---|\n| `name` | Yes | Unique identifier, use `mcp-server-` prefix |\n| `description` | Yes | One sentence describing what Claude can do with it |\n| `command` | Yes | Executable to run (`npx`, `node`, `python`, etc.) |\n| `args` | Yes | Arguments array. Use `$VAR_NAME` for env var substitution |\n| `envVars` | Yes | List of required environment variables (can be empty `[]`) |\n| `tags` | Yes | Array of lowercase tags for search |\n| `homepage` | Yes | Link to the server's documentation or source |\n\n---\n\n## Using a custom registry\n\nOrganizations can host a private registry with internal MCP servers:\n\n```bash\nnpx @amritessh/mcp-hub list --registry https://your-internal-host/mcp-registry.json\nnpx @amritessh/mcp-hub install my-internal-server --registry https://your-internal-host/mcp-registry.json\n```\n\n---\n\n## Contributing\n\nThe registry is the most valuable part — contributions of new MCP servers are very welcome.\n\n```bash\ngit clone https://github.com/amritessh/mcp-hub\ncd mcp-hub\nnpm install\nnode dist/index.js list     # test with local registry\n```\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-9736eb03f4c3589b9c69fc409c00b640"}