MCP Registry Manager π
Centralized discovery and quality scoring for the exploding MCP (Model Context Protocol) ecosystem.
What It Does
The MCP ecosystem is growing fast β awesome-mcp-servers, AllInOneMCP, GitHub β but no unified discovery or quality checks.
MCP Registry Manager provides:
- Unified discovery β Aggregate servers from multiple sources
- Quality scoring β Test coverage, documentation, maintenance status
- Semantic search β "Find servers for file operations" (not just keyword search)
- Install management β Install/uninstall with dependency resolution
- Categorization β Organize by domain (files, databases, APIs, dev tools)
Problem It Solves
MCP is becoming the "USB-C of agent tools" but:
- Discovery is fragmented (GitHub repos, lists, registries)
- No quality signals (which servers are production-ready?)
- No semantic search (can't find "what does this do?")
- No unified management
Usage
# Discover all MCP servers
python3 scripts/mcp-registry.py --discover
# Search semantically
python3 scripts/mcp-registry.py --search "file system operations"
# Get quality report for a server
python3 scripts/mcp-registry.py --score @modelcontext/official-filesystem
# Install a server
python3 scripts/mcp-registry.py --install @modelcontext/official-filesystem
# List installed servers
python3 scripts/mcp-registry.py --list
# Update all installed servers
python3 scripts/mcp-registry.py --update
Quality Score Formula
Quality = (0.4 * TestCoverage) + (0.3 * Documentation) + (0.2 * Maintenance) + (0.1 * Community)
Where:
- TestCoverage = % of code covered by tests
- Documentation = README completeness, API docs, examples
- Maintenance = Recent commits, responsive issues
- Community = Stars, forks, contributors
Data Sources
| Source |
Type |
Coverage |
| awesome-mcp-servers |
Curated list |
Manual discovery |
| GitHub Search |
Repos with mcp-server topic |
Fresh discoveries |
| AllInOneMCP |
API registry |
Centralized metadata |
| Klavis AI |
MCP integrations |
Production services |
Categories
- Files β Filesystem, storage, S3
- Databases β PostgreSQL, MongoDB, Redis, SQLite
- APIs β HTTP, GraphQL, REST
- Dev Tools β Git, Docker, CI/CD
- Media β Image processing, video, audio
- Communication β Email, Slack, Discord
- Utilities β Time, crypto, encryption
Architecture
βββββββββββββββββββ
β Discovery β β awesome-mcp, GitHub, AllInOneMCP
ββββββββββ¬βββββββββ
β
βΌ
βββββββββββββββββββ
β Registry DB β β SQLite/PostgreSQL with metadata
ββββββββββ¬βββββββββ
β
βΌ
βββββββββββββββββββ
β Quality Scorer β β Test coverage, docs, maintenance
ββββββββββ¬βββββββββ
β
βΌ
βββββββββββββββββββ
β Semantic Searchβ β Embeddings + vector search
ββββββββββ¬βββββββββ
β
βΌ
βββββββββββββββββββ
β CLI Interface β β Install/uninstall/update
βββββββββββββββββββ
Requirements
- Python 3.9+
- requests (for GitHub API)
- sentence-transformers (for semantic search)
- numpy/pandas (for scoring)
Installation
# Clone repo
git clone https://github.com/orosha-ai/mcp-registry-manager
# Install dependencies
pip install requests sentence-transformers numpy pandas
# Run discovery
python3 scripts/mcp-registry.py --discover
Inspiration
- MCP Server Stack guide β Essential servers list
- awesome-mcp-servers β Community-curated directory
- AllInOneMCP β Remote MCP registry
- Klavis AI β MCP integration platform
Local-Only Promise
- Registry metadata is cached locally
- Install operations run locally
- No telemetry or data sent to external services
Version History
- v0.1 β MVP: Discovery, quality scoring, semantic search
- Roadmap: GitHub integration, CI tests, auto-updates
1---2name: mcp-registry-manager3description: Centralized discovery and quality scoring for the exploding MCP (Model Context Protocol) ecosystem.4---5
6# MCP Registry Manager π
7
8Centralized discovery and quality scoring for the exploding MCP (Model Context Protocol) ecosystem.
9
10## What It Does
11
12The MCP ecosystem is growing fast β `awesome-mcp-servers`, `AllInOneMCP`, GitHub β but no unified discovery or quality checks.
13
14**MCP Registry Manager** provides:
15- **Unified discovery** β Aggregate servers from multiple sources
16- **Quality scoring** β Test coverage, documentation, maintenance status
17- **Semantic search** β "Find servers for file operations" (not just keyword search)
18- **Install management** β Install/uninstall with dependency resolution
19- **Categorization** β Organize by domain (files, databases, APIs, dev tools)
20
21## Problem It Solves
22
23MCP is becoming the "USB-C of agent tools" but:
24- Discovery is fragmented (GitHub repos, lists, registries)
25- No quality signals (which servers are production-ready?)
26- No semantic search (can't find "what does this do?")
27- No unified management
28
29## Usage
30
31```bash
32# Discover all MCP servers
33python3 scripts/mcp-registry.py --discover
34
35# Search semantically
36python3 scripts/mcp-registry.py --search "file system operations"
37
38# Get quality report for a server
39python3 scripts/mcp-registry.py --score @modelcontext/official-filesystem
40
41# Install a server
42python3 scripts/mcp-registry.py --install @modelcontext/official-filesystem
43
44# List installed servers
45python3 scripts/mcp-registry.py --list
46
47# Update all installed servers
48python3 scripts/mcp-registry.py --update
49```
50
51## Quality Score Formula
52
53```
54Quality = (0.4 * TestCoverage) + (0.3 * Documentation) + (0.2 * Maintenance) + (0.1 * Community)
55
56Where:
57- TestCoverage = % of code covered by tests
58- Documentation = README completeness, API docs, examples
59- Maintenance = Recent commits, responsive issues
60- Community = Stars, forks, contributors
61```
62
63## Data Sources
64
65| Source | Type | Coverage |
66|---------|--------|-----------|
67| awesome-mcp-servers | Curated list | Manual discovery |
68| GitHub Search | Repos with `mcp-server` topic | Fresh discoveries |
69| AllInOneMCP | API registry | Centralized metadata |
70| Klavis AI | MCP integrations | Production services |
71
72## Categories
73
74- **Files** β Filesystem, storage, S3
75- **Databases** β PostgreSQL, MongoDB, Redis, SQLite
76- **APIs** β HTTP, GraphQL, REST
77- **Dev Tools** β Git, Docker, CI/CD
78- **Media** β Image processing, video, audio
79- **Communication** β Email, Slack, Discord
80- **Utilities** β Time, crypto, encryption
81
82## Architecture
83
84```
85βββββββββββββββββββ
86β Discovery β β awesome-mcp, GitHub, AllInOneMCP
87ββββββββββ¬βββββββββ
88 β
89 βΌ
90βββββββββββββββββββ
91β Registry DB β β SQLite/PostgreSQL with metadata
92ββββββββββ¬βββββββββ
93 β
94 βΌ
95βββββββββββββββββββ
96β Quality Scorer β β Test coverage, docs, maintenance
97ββββββββββ¬βββββββββ
98 β
99 βΌ
100βββββββββββββββββββ
101β Semantic Searchβ β Embeddings + vector search
102ββββββββββ¬βββββββββ
103 β
104 βΌ
105βββββββββββββββββββ
106β CLI Interface β β Install/uninstall/update
107βββββββββββββββββββ
108```
109
110## Requirements
111
112- Python 3.9+
113- requests (for GitHub API)
114- sentence-transformers (for semantic search)
115- numpy/pandas (for scoring)
116
117## Installation
118
119```bash
120# Clone repo
121git clone https://github.com/orosha-ai/mcp-registry-manager
122
123# Install dependencies
124pip install requests sentence-transformers numpy pandas
125
126# Run discovery
127python3 scripts/mcp-registry.py --discover
128```
129
130## Inspiration
131
132- **MCP Server Stack guide** β Essential servers list
133- **awesome-mcp-servers** β Community-curated directory
134- **AllInOneMCP** β Remote MCP registry
135- **Klavis AI** β MCP integration platform
136
137## Local-Only Promise
138
139- Registry metadata is cached locally
140- Install operations run locally
141- No telemetry or data sent to external services
142
143## Version History
144
145- **v0.1** β MVP: Discovery, quality scoring, semantic search
146- Roadmap: GitHub integration, CI tests, auto-updates