MCP Servers Search

Pesquise e descubra servidores MCP disponíveis no repositório oficial.

Documentação

MCP Servers Search

Um servidor MCP (Model Context Protocol) que fornece ferramentas para consultar e descobrir servidores MCP disponíveis no repositório oficial modelcontextprotocol/servers.

547 servidores MCP em junho de 2025.

Recursos

  • Listar Servidores: Navegue por todos os servidores MCP disponíveis com filtro por categoria
  • Buscar: Encontre servidores por nome, descrição ou autor
  • Busca por Recurso: Descubra servidores que oferecem capacidades específicas
  • Descoberta Aleatória: Obtenha sugestões aleatórias de servidores para exploração
  • Cache: Cache eficiente para minimizar chamadas à API do GitHub

Instalação

Usando npm

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

A partir do código-fonte

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

Uso

Autônomo

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

# Or if installed globally
mcp-servers-search

Com Claude Desktop

Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json no macOS):

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

Ferramentas Disponíveis

1. list_servers

Lista todos os servidores MCP disponíveis com filtragem opcional.

Parâmetros:

  • category (opcional): Filtro por categoria - "reference", "official", "community" ou "all" (padrão)
  • search (opcional): Busca servidores por nome ou descrição
  • limit (opcional): Número máximo de resultados (padrão: 20)

Exemplo:

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

2. get_server_details

Obtém informações detalhadas sobre um servidor MCP específico.

Parâmetros:

  • name (obrigatório): O nome do servidor MCP

Exemplo:

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

3. search_servers_by_feature

Busca servidores que oferecem recursos ou capacidades específicas.

Parâmetros:

  • feature (obrigatório): O recurso a ser buscado (ex.: "database", "api", "blockchain")
  • limit (opcional): Número máximo de resultados (padrão: 10)

Exemplo:

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

4. get_random_servers

Obtém uma seleção aleatória de servidores MCP para descoberta.

Parâmetros:

  • count (opcional): Número de servidores aleatórios (padrão: 5)
  • category (opcional): Filtro por categoria (padrão: "all")

Exemplo:

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

5. refresh_server_list

Força a atualização da lista em cache de servidores MCP do GitHub.

Exemplo:

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

Desenvolvimento

Configuração

# Install dependencies
npm install

# Run normally
npm start

# Run tests
npm test

Testes

O projeto inclui uma suíte de testes abrangente com Mocha que testa a funcionalidade de análise do README. Os testes cobrem:

  • Entradas em formato padrão: [Name](link) - description
  • Entradas em formato negrito: **[Name](link)** - description
  • Entradas em formato de lista: - [Name](link) - description
  • Extração de autor: (by AuthorName)
  • Detecção de categoria (reference, official, community)
  • Limpeza de descrição (remoção de links incorporados)
  • Tratamento de caracteres especiais (preservação de crases)

Execute os testes com:

npm test

Exemplos

Usando com Claude Desktop

Após a configuração, você pode perguntar ao Claude:

  • "Quais servidores MCP estão disponíveis para operações de banco de dados?"
  • "Mostre-me todos os servidores MCP oficiais"
  • "Encontre servidores MCP relacionados a IA ou aprendizado de máquina"
  • "Dê-me 5 servidores comunitários aleatórios para explorar"
  • "Conte-me mais sobre o servidor MCP do GitHub"

Uso Programático

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

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

Cache

O servidor armazena em cache a lista de servidores MCP disponíveis por 1 hora para minimizar chamadas à API do GitHub. Você pode forçar uma atualização usando a ferramenta refresh_server_list.

Contribuindo

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

Licença

MIT - consulte o arquivo LICENSE para detalhes

Agradecimentos