Discover MCP Servers Effortlessly with @atonomus/mcp-servers-search 🔍

George Mihailov — Tue, 24 Jun 2025 02:26:42 +0000

Ever found yourself wondering what Model Context Protocol (MCP) servers are available for your Claude Desktop setup? Or maybe you're looking for servers with specific capabilities like database access or blockchain integration? Look no further! The @atonomus/mcp-servers-search package is here to make MCP server discovery a breeze.

What is MCP and Why Should You Care? 🤔

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between AI assistants like Claude and external tools and data sources. Think of MCP servers as bridges that give AI assistants superpowers - from accessing databases to interacting with APIs and beyond.

Introducing @atonomus/mcp-servers-search 🚀

This npm package provides a comprehensive toolset for querying and discovering available MCP servers from the official modelcontextprotocol/servers repository. Whether you're a developer looking to enhance your Claude Desktop experience or building your own MCP-powered applications, this package has got you covered.

Key Features ✨

List Servers: Browse all available MCP servers with filtering by category
Smart Search: Find servers by name, description, or author
Feature Discovery: Search for servers that provide specific capabilities
Random Exploration: Get random server suggestions to discover new tools
Efficient Caching: Minimizes GitHub API calls with smart caching

Getting Started 🏁

Installation

You can install the package globally or use it directly with npx:

# Install globally
npm install -g @atonomus/mcp-servers-search

# Or use directly with npx (no installation needed!)
npx @atonomus/mcp-servers-search

Integrating with Claude Desktop

To use this tool with Claude Desktop, add it to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Available Tools and Real-World Examples 💡

1. List All Servers

Want to see what's available? Use the list_servers tool:

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

Example Use Case: "Show me all official MCP servers" - Perfect when you want to explore trusted, officially maintained servers.

2. Search by Keywords

Looking for something specific? The search functionality has you covered:

{
  "name": "list_servers",
  "arguments": {
    "search": "database",
    "limit": 5
  }
}

Example Use Case: "Find MCP servers for database operations" - Quickly locate servers that can help with database-related tasks.

3. Discover by Features

Need servers with specific capabilities? Use the feature search:

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

Example Use Case: "What servers support blockchain integration?" - Find specialized servers for your specific needs.

4. Get Server Details

Want more information about a specific server?

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

Example Use Case: "Tell me more about the GitHub MCP server" - Get detailed information including description, author, and installation instructions.

5. Random Discovery

Feeling adventurous? Discover new servers randomly:

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

Example Use Case: "Show me 3 random community servers to explore" - Great for discovering hidden gems in the MCP ecosystem.

Practical Claude Desktop Workflows 🎯

Once configured, you can ask Claude natural language questions like:

📊 "What MCP servers can help me with data analysis?"
🔗 "Find servers that integrate with external APIs"
🤖 "Show me AI and machine learning related MCP servers"
🎲 "Give me 5 random servers to try out"
🔄 "Refresh the server list to get the latest updates"

Advanced Usage: Programmatic Integration 🛠️

Want to use this in your own projects? Here's how:

import { MCPToolsQueryServer } from '@atonomus/mcp-servers-search';

async function discoverServers() {
  const server = new MCPToolsQueryServer();

  // List all servers
  const allServers = await server.listServers({ category: 'all' });

  // Search for specific features
  const dbServers = await server.searchServersByFeature({ 
    feature: 'database' 
  });

  // Get random suggestions
  const randomPicks = await server.getRandomServers({ 
    count: 5, 
    category: 'community' 
  });

  return { allServers, dbServers, randomPicks };
}

Performance and Caching 🏎️

The package implements intelligent caching to minimize GitHub API calls:

Server list is cached for 1 hour
Use refresh_server_list to force an update when needed
Efficient parsing of the official servers README

Testing and Reliability 🧪

The package includes comprehensive Mocha test coverage for:

Multiple README format parsing (standard, bold, list formats)
Author extraction and category detection
Description cleaning and special character handling
Edge cases and error scenarios

Run tests with:

npm test

Contributing to the Project 🤝

This is an open-source project, and contributions are welcome! Here's how you can help:

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Check out the GitHub repository for more details.

Future Possibilities 🔮

The MCP ecosystem is rapidly evolving, and this package will grow with it. Some exciting possibilities:

Server ratings and reviews: Community feedback on server quality
Dependency resolution: Automatically install required dependencies
Server templates: Quick-start configurations for common use cases
Integration testing: Verify server compatibility before installation

Conclusion 🎉

The @atonomus/mcp-servers-search package transforms MCP server discovery from a manual GitHub browsing experience into a powerful, searchable tool. Whether you're using it through Claude Desktop or integrating it into your own projects, it makes the MCP ecosystem more accessible and discoverable.

Give it a try today and unlock the full potential of MCP servers in your AI-powered workflows!

Links:

Happy server hunting! 🕵️‍♂️

DEV Community: Atonomus