DEV Community

Atonomus profile image George Mihailov
George Mihailov for Atonomus

Posted on

Discover MCP Servers Effortlessly with @atonomus/mcp-servers-search ๐Ÿ”

#mcp #ai #claude #server

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
Enter fullscreen mode Exit fullscreen mode

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"]
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

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
  }
}
Enter fullscreen mode Exit fullscreen mode

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
  }
}
Enter fullscreen mode Exit fullscreen mode

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
  }
}
Enter fullscreen mode Exit fullscreen mode

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"
  }
}
Enter fullscreen mode Exit fullscreen mode

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"
  }
}
Enter fullscreen mode Exit fullscreen mode

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 };
}
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Contributing to the Project ๐Ÿค

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

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. 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! ๐Ÿ•ต๏ธโ€โ™‚๏ธ

Top comments (0)