Skip to content

Diwakarsrd/MCPHUB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCPHub

The open registry for Model Context Protocol servers.

License: MIT Registry PRs Welcome

npm install -g mcphub
mcphub search postgres
mcphub install postgres

Browse Registry · Submit a Server · CLI Docs


MCPHub is the community registry for Model Context Protocol servers — think npm, but for MCP. One place to discover, install, and publish the servers that connect AI agents to every tool, database, and API.

The registry is a single JSON file. The CLI writes directly to your config. No accounts, no lock-in, no proprietary dependencies.


Install

npm install -g mcphub

Or run without installing:

npx mcphub <command>

Requirements: Node.js 18+


CLI

# Search
mcphub search postgres
mcphub search "browser automation"
mcphub search --category "Dev Tools"

# Install a server into your MCP config
mcphub install filesystem
mcphub install github
mcphub install postgres

# Manage
mcphub list              # show installed servers
mcphub info stripe       # detailed info + tools
mcphub remove slack      # remove from config
mcphub update            # sync all to latest

# Publish your own
mcphub publish

Featured Servers

Server Category Stars Install
filesystem Storage 12.4k mcphub install filesystem
github Dev Tools 9.8k mcphub install github
postgres Databases 7.2k mcphub install postgres
memory AI/ML 5.8k mcphub install memory
slack Productivity 5.4k mcphub install slack
brave-search Search 6.1k mcphub install brave-search
stripe Payments 4.8k mcphub install stripe
sequential-thinking AI/ML 4.9k mcphub install sequential-thinking
sqlite Databases 4.6k mcphub install sqlite
puppeteer Automation 5.1k mcphub install puppeteer

See all 22 servers in the registry →


How the registry works

The registry is registry/servers.json — a single file maintained by the community via pull requests. Every entry describes one MCP server:

{
  "name": "my-server",
  "author": "your-github-handle",
  "description": "What it does.",
  "category": "Dev Tools",
  "tags": ["tag1", "tag2"],
  "install": "npx my-mcp-server",
  "homepage": "https://github.com/you/my-mcp-server",
  "license": "MIT",
  "tools": [
    { "name": "tool_name", "description": "What this tool does." }
  ]
}

Pull requests are reviewed within 48 hours.


Project layout

mcphub/
├── registry/
│   ├── servers.json        # The canonical registry — edit this to add a server
│   └── schema.json         # JSON Schema for validation
├── cli/                    # npx mcphub — TypeScript CLI
│   └── src/
│       ├── commands/       # search, install, list, info, remove, update, publish
│       └── utils/          # registry fetcher, claude config reader/writer
├── website/
│   └── index.html          # Full registry browser — zero build step, deploy anywhere
├── scripts/
│   └── validate.js         # Validate the registry before opening a PR
└── .github/
    └── workflows/          # CI validates registry + builds CLI on every PR

Hosting the website

The website is a single HTML file with no build step. Deploy it anywhere:

GitHub Pages (free, automatic):

  1. Go to your repo → Settings → Pages
  2. Source: Deploy from branch → main/website
  3. Done. Available at https://Diwakarsrd.github.io/MCPHUB/website/

Vercel (recommended, custom domain):

npx vercel website/

Netlify: Drag and drop the website/ folder at netlify.com/drop.

Any static host: Just serve website/index.html.


Contributing

See CONTRIBUTING.md for full details.

The short version:

  1. Fork this repo
  2. Add your server to registry/servers.json
  3. Run node scripts/validate.js to check for errors
  4. Open a pull request

Roadmap

  • Registry JSON + schema validation
  • CLI: install / search / list / info / remove / update
  • Website: browse, search, filter, dark mode
  • CI: auto-validate registry on every PR
  • CLI: mcphub init — scaffold a new MCP server
  • Server health badges (auto-tested weekly)
  • Verified publisher program
  • REST API: GET /api/servers
  • Weekly community digest

Self-hosting the registry

Fork this repo and point the CLI at your own registry:

mcphub install myserver --registry https://raw.githubusercontent.com/YOUR_ORG/mcp-registry/main/registry/servers.json

License

MIT — see LICENSE.

All servers listed in the registry are independently licensed by their respective authors.

About

The open registry for MCP servers — install any MCP server in one command

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors