MCP Server Discovery

Discover, search, and manage MCP (Model Context Protocol) servers. Use when the user needs to find MCP servers, get server information, generate MCP client c...

Security Scan

The skill mostly lists a hard-coded registry and generates client config strings rather than performing live discovery; some documentation mentions external registries and credentials but the runtime code doesn't actually fetch or require them — this mismatch warrants caution.

Purpose & Capability

The name/description promise 'discover' and 'manage' MCP servers including official/community registries, but the shipped script only enumerates a hard-coded KNOWN_SERVERS map and generates configuration JSON. The script declares registry URLs (GitHub raw and API) but never uses them. This is coherent for a local registry helper but inconsistent if you expect live network discovery.

Instruction Scope

SKILL.md instructs the agent to run the included script for list/search/info/config. The instructions do not ask the agent to read unrelated files, environment variables, or transmit data. However documentation and README reference remote registries and server installs that may require credentials (e.g., GITHUB_TOKEN) and external tooling (npx), which the skill does not automatically handle.

Install Mechanism

There is no install spec (instruction-only) and the code is included as a script. Nothing in the skill itself downloads or executes remote code. Note: the generated install commands use 'npx' to fetch server implementations — running those is outside this skill and will execute code from npm.

Credentials

The skill declares no required environment variables and the script does not access any. However the README/references mention that some server integrations (e.g., GitHub) require a GITHUB_TOKEN; those are not requested or used by this skill, so users must supply them separately when installing specific servers.

Persistence & Privilege

The skill is not always-enabled and does not request elevated persistence or modify other skills. It runs as a simple script when invoked.

What to consider before installing

This skill is a lightweight local helper that exposes a static list of known MCP servers and can generate MCP client config snippets. Before installing or using it: 1) Understand it does not perform live network discovery despite references to registries — expect static results unless the script is extended. 2) Be cautious when you run any generated 'npx -y ...' install commands: npx will fetch and execute packages from npm (review the package source/repos first). 3) Some servers (e.g., GitHub) may require credentials like GITHUB_TOKEN; the skill won’t prompt for or manage those. 4) If you expected automatic registry syncing or real-time discovery, ask the author or inspect/modify the script to perform authenticated registry queries. If you rely on this for sensitive environments, audit the referenced upstream server repos before installing them with npx.

This skill helps you discover and manage MCP (Model Context Protocol) servers.

What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI systems to connect with external data sources and tools. It provides a standardized way for AI assistants to access files, databases, APIs, and other resources.

Available Commands

Use the scripts/mcp_discover.py script for all MCP operations:

List Available Servers

python3 scripts/mcp_discover.py list

Filter by category:

python3 scripts/mcp_discover.py list --category database

Categories: filesystem, dev, database, web, search, memory

Search for Servers

python3 scripts/mcp_discover.py search --query "database"

Get Server Details

python3 scripts/mcp_discover.py info --name postgres

Generate MCP Client Configuration

python3 scripts/mcp_discover.py config --servers "filesystem,github,memory"

Common Workflows

Setting up a new MCP client

1. List available servers to see options
2. Select the servers you need
3. Generate configuration with those servers
4. Save the output to your MCP client's config file

Finding the right server

1. Use search with keywords related to your need
2. Use info to get detailed information about a specific server
3. Check the install command and URL for setup instructions

Server Categories

• filesystem: File system access and management
• dev: Development tools and integrations (GitHub, etc.)
• database: Database connections (PostgreSQL, SQLite)
• web: Web scraping and content fetching
• search: Search engine integrations
• memory: Persistent memory and knowledge graph

JSON Output

All commands support --json flag for programmatic use:

python3 scripts/mcp_discover.py list --json