MCP Servers Search

Busca y descubre servidores MCP disponibles en el repositorio oficial.

Documentación

MCP Servers Search

Un servidor MCP (Model Context Protocol) que proporciona herramientas para consultar y descubrir servidores MCP disponibles desde el repositorio oficial modelcontextprotocol/servers.

547 servidores MCP a junio de 2025.

Características

  • Listar servidores: Explora todos los servidores MCP disponibles con filtrado por categoría
  • Buscar: Encuentra servidores por nombre, descripción o autor
  • Búsqueda por características: Descubre servidores que ofrecen capacidades específicas
  • Descubrimiento aleatorio: Obtén sugerencias aleatorias de servidores para explorar
  • Caché: Caché eficiente para minimizar las llamadas a la API de GitHub

Instalación

Usando npm

npm install -g @atonomus/mcp-servers-search

Desde el código fuente

git clone https://github.com/atonomus/mcp-servers-search.git
cd mcp-servers-search
npm install

Uso

Independiente

# Run directly with npx
npx @atonomus/mcp-servers-search

# Or if installed globally
mcp-servers-search

Con Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "servers-search": {
      "command": "npx",
      "args": ["-y", "@atonomus/mcp-servers-search"]
    }
  }
}

Herramientas disponibles

1. list_servers

Lista todos los servidores MCP disponibles con filtrado opcional.

Parámetros:

  • category (opcional): Filtra por categoría - "reference", "official", "community" o "all" (predeterminado)
  • search (opcional): Busca servidores por nombre o descripción
  • limit (opcional): Número máximo de resultados (predeterminado: 20)

Ejemplo:

{
  "name": "list_servers",
  "arguments": {
    "category": "official",
    "search": "database",
    "limit": 10
  }
}

2. get_server_details

Obtén información detallada sobre un servidor MCP específico.

Parámetros:

  • name (obligatorio): El nombre del servidor MCP

Ejemplo:

{
  "name": "get_server_details",
  "arguments": {
    "name": "GitHub"
  }
}

3. search_servers_by_feature

Busca servidores que ofrezcan características o capacidades específicas.

Parámetros:

  • feature (obligatorio): La característica a buscar (p. ej., "database", "api", "blockchain")
  • limit (opcional): Número máximo de resultados (predeterminado: 10)

Ejemplo:

{
  "name": "search_servers_by_feature",
  "arguments": {
    "feature": "blockchain",
    "limit": 5
  }
}

4. get_random_servers

Obtén una selección aleatoria de servidores MCP para descubrir.

Parámetros:

  • count (opcional): Número de servidores aleatorios (predeterminado: 5)
  • category (opcional): Filtra por categoría (predeterminado: "all")

Ejemplo:

{
  "name": "get_random_servers",
  "arguments": {
    "count": 3,
    "category": "community"
  }
}

5. refresh_server_list

Fuerza la actualización de la lista en caché de servidores MCP desde GitHub.

Ejemplo:

{
  "name": "refresh_server_list",
  "arguments": {}
}

Desarrollo

Configuración

# Install dependencies
npm install

# Run normally
npm start

# Run tests
npm test

Pruebas

El proyecto incluye un conjunto completo de pruebas Mocha que verifica la funcionalidad de análisis del README. Las pruebas cubren:

  • Entradas de formato estándar: [Name](link) - description
  • Entradas de formato en negrita: **[Name](link)** - description
  • Entradas de formato de lista: - [Name](link) - description
  • Extracción de autor: (by AuthorName)
  • Detección de categoría (reference, official, community)
  • Limpieza de descripciones (eliminación de enlaces incrustados)
  • Manejo de caracteres especiales (conservación de comillas invertidas)

Ejecuta las pruebas con:

npm test

Ejemplos

Uso con Claude Desktop

Una vez configurado, puedes preguntar a Claude:

  • "¿Qué servidores MCP están disponibles para operaciones de base de datos?"
  • "Muéstrame todos los servidores MCP oficiales"
  • "Encuentra servidores MCP relacionados con IA o aprendizaje automático"
  • "Dame 5 servidores comunitarios aleatorios para explorar"
  • "Cuéntame más sobre el servidor MCP de GitHub"

Uso programático

// Example of using the server programmatically
import { MCPToolsQueryServer } from '@atonomus/mcp-servers-search';

const server = new MCPToolsQueryServer();
await server.run();

Caché

El servidor almacena en caché la lista de servidores MCP disponibles durante 1 hora para minimizar las llamadas a la API de GitHub. Puedes forzar una actualización usando la herramienta refresh_server_list.

Contribuciones

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/amazing-feature)
  3. Haz commit de tus cambios (git commit -m 'Add some amazing feature')
  4. Haz push a la rama (git push origin feature/amazing-feature)
  5. Abre un Pull Request

Licencia

MIT - consulta el archivo LICENSE para más detalles

Agradecimientos