Skip to main content
Glama

MCP Advisor

MIT License
382
16
  • Apple
  • Linux

MCP Advisor

English | 简体中文

Introduction

MCP Advisor is a discovery and recommendation service that helps AI assistants explore Model Context Protocol (MCP) servers using natural language queries. It makes it easier for users to find and leverage MCP tools suitable for specific tasks.

Features

  • Natural Language Search: Find MCP services using conversational queries
  • Rich Metadata: Get detailed information about each service
  • Real-time Updates: Always in sync with the latest MCP services
  • Easy Integration: Simple configuration for any MCP-compatible AI assistant
  • Hybrid Search Engine: Advanced search capabilities combining vector search and text matching
  • Multi-provider Support: Support for multiple search providers executing in parallel

Documentation Navigation

Quick Start

Installation

The fastest way is to integrate MCP Advisor through MCP configuration:

{ "mcpServers": { "mcpadvisor": { "command": "npx", "args": ["-y", "@xiaohui-wang/mcpadvisor"] } } }

Add this configuration to your AI assistant's MCP settings file:

  • MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %AppData%\Claude\claude_desktop_config.json

For more installation methods, see the Installation Guide.

Demo

Developer Guide

Architecture Overview

MCP Advisor adopts a modular architecture with clear separation of concerns and functional programming principles:

Core Components

  1. Search Service Layer
    • Unified search interface and provider aggregation
    • Support for multiple search providers executing in parallel
    • Configurable search options (limit, minSimilarity)
  2. Search Providers
    • Meilisearch Provider: Vector search using Meilisearch
    • GetMCP Provider: API search from the GetMCP registry
    • Compass Provider: API search from the Compass registry
    • Offline Provider: Hybrid search combining text and vectors
  3. Hybrid Search Strategy
    • Intelligent combination of text matching and vector search
    • Configurable weight balancing
    • Smart adaptive filtering mechanisms
  4. Transport Layer
    • Stdio (CLI default)
    • SSE (Web integration)
    • REST API endpoints

For more detailed architecture documentation, see ARCHITECTURE.md.

Technical Highlights

Advanced Search Techniques

  1. Vector Normalization
    • All vectors are normalized to unit length (magnitude = 1)
    • Ensures consistent cosine similarity calculations
    • Improves search precision by focusing on direction rather than magnitude
  2. Parallel Search Execution
    • Vector search and text search run in parallel
    • Leverages Promise.all for optimal performance
    • Fallback mechanisms enabled if either search fails
  3. Weighted Result Merging
    • Configurable weights between vector and text results
    • Default: vector similarity (70%), text matching (30%)

Error Handling and Logging System

MCP Advisor implements robust error handling and logging systems:

  1. Contextual Error Formatting
    • Standardized error object enrichment
    • Stack trace preservation and formatting
    • Error type categorization and standardization
  2. Graceful Degradation
    • Multi-provider fallback strategies
    • Partial result processing
    • Default responses for critical failures

For more technical details, see TECHNICAL_DETAILS.md.

Developer Quick Start

Development Environment Setup

  1. Clone the repository
  2. Install dependencies:
    npm install
  3. Configure environment variables (see INSTALLATION.md)

Library Usage

import { SearchService } from '@xiaohui-wang/mcpadvisor'; // Initialize search service const searchService = new SearchService(); // Search for MCP servers const results = await searchService.search('vector database integration'); console.log(results);

Transport Options

MCP Advisor supports multiple transport methods:

  1. Stdio Transport (default) - Suitable for command-line tools
  2. SSE Transport - Suitable for web integration
  3. REST Transport - Provides REST API endpoints

For more development details, see DEVELOPER_GUIDE.md.

Contribution Guidelines

  1. Follow commit message conventions:
    • Use lowercase types (feat, fix, docs, etc.)
    • Write descriptive messages in sentence format
  2. Ensure code quality:
    • Run tests: npm test
    • Check types: npm run type-check
    • Lint code: npm run lint

For detailed contribution guidelines, see CONTRIBUTING.md.

Usage Examples

Example Queries

Here are some example queries you can use with MCP Advisor:

"Find MCP servers for natural language processing" "MCP servers for financial data analysis" "E-commerce recommendation engine MCP servers" "MCP servers with image recognition capabilities" "Weather data processing MCP servers" "Document summarization MCP servers"

Example Response

[ { "title": "NLP Toolkit", "description": "Comprehensive natural language processing toolkit with sentiment analysis, entity recognition, and text summarization capabilities.", "github_url": "https://github.com/example/nlp-toolkit", "similarity": 0.92 }, { "title": "Text Processor", "description": "Efficient text processing MCP server with multi-language support.", "github_url": "https://github.com/example/text-processor", "similarity": 0.85 } ]

For more examples, see EXAMPLES.md.

Troubleshooting

Common Issues

  1. Connection Refused
    • Ensure the server is running on the specified port
    • Check firewall settings
  2. No Results Returned
    • Try a more general query
    • Check network connection to registry APIs
  3. Performance Issues
    • Consider adding more specific search terms
    • Check server resources (CPU/memory)

For more troubleshooting information, see TROUBLESHOOTING.md.

Search Providers

MCP Advisor supports multiple search providers that can be used simultaneously:

  1. Compass Search Provider: Retrieves MCP server information using the Compass API
  2. GetMCP Search Provider: Uses the GetMCP API and vector search for semantic matching
  3. Meilisearch Search Provider: Uses Meilisearch for fast, fault-tolerant text search

For detailed information about search providers, see SEARCH_PROVIDERS.md.

API Documentation

For detailed API documentation, see API_REFERENCE.md.

Roadmap

MCP Advisor is evolving from a simple recommendation system to an intelligent agent orchestration platform. Our vision is to create a system that not only recommends the right MCP servers but also learns from interactions and helps agents dynamically plan and execute complex tasks.

Major Development Phases

  1. Recommendation Capability Optimization (2025 Q2-Q3)
    • Accept user feedback
    • Refine recommendation effectiveness
    • Introduce more indices

For a detailed roadmap, see ROADMAP.md.

Testing

Use inspector for testing:

npx @modelcontextprotocol/inspector

License

This project is licensed under the MIT License - see the LICENSE file for details.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A discovery and recommendation service that helps AI assistants find Model Context Protocol servers based on natural language queries.

  1. Introduction
    1. Features
      1. Documentation Navigation
        1. Quick Start
          1. Installation
          2. Demo
        2. Developer Guide
          1. Architecture Overview
          2. Core Components
        3. Technical Highlights
          1. Advanced Search Techniques
          2. Error Handling and Logging System
        4. Developer Quick Start
          1. Development Environment Setup
          2. Library Usage
          3. Transport Options
        5. Contribution Guidelines
          1. Usage Examples
            1. Example Queries
            2. Example Response
          2. Troubleshooting
            1. Common Issues
          3. Search Providers
            1. API Documentation
              1. Roadmap
                1. Major Development Phases
              2. Testing
                1. License

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
                    Last updated -
                    40
                    313
                    TypeScript
                    MIT License
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
                    Last updated -
                    9
                    Python
                    MIT License
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
                    Last updated -
                    85
                    2
                    TypeScript
                  • A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI agents to generate, fetch, and manage UI components through natural language interactions.
                    Last updated -
                    3
                    19
                    4
                    TypeScript

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/istarwyh/mcpadvisor'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server