Skip to main content
Glama
deenesjakoruzh

MCP Advisor

by istarwyh
npmGitHub
TypeScript
MIT License
553
32
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP 顾问

英语|简体中文

介绍

MCP Advisor 是一项发现和推荐服务，可帮助 AI 助手使用自然语言查询探索模型上下文协议 (MCP) 服务器。它使用户能够更轻松地找到并使用适合特定任务的 MCP 工具。

特征

  • 自然语言搜索：使用对话查询查找 MCP 服务
  • 丰富的元数据：获取有关每项服务的详细信息
  • 实时更新：始终与最新的 MCP 服务同步
  • 轻松集成：任何兼容 MCP 的 AI 助手均可轻松配置
  • 混合搜索引擎：结合矢量搜索和文本匹配的高级搜索功能
  • 多提供商支持：支持多个搜索提供商并行执行

文档导航

快速入门

安装

最快的方式是通过 MCP 配置集成 MCP Advisor：

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

将此配置添加到您的 AI 助手的 MCP 设置文件中：

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

更多安装方法请参见安装指南。

演示

开发者指南

架构概述

MCP Advisor 采用模块化架构，具有明确的关注点分离和函数式编程原则：

核心组件

  1. 搜索服务层
    • 统一搜索界面和提供商聚合
    • 支持多个搜索提供商并行执行
    • 可配置的搜索选项（限制、最小相似度）
  2. 搜索提供商
    • Meilisearch 提供商：使用 Meilisearch 进行矢量搜索
    • GetMCP 提供程序：从 GetMCP 注册表中搜索 API
    • Compass Provider ：从 Compass 注册表中搜索 API
    • 离线提供商：结合文本和向量的混合搜索
  3. 混合搜索策略
    • 文本匹配与向量搜索的智能结合
    • 可配置的重量平衡
    • 智能自适应过滤机制
  4. 传输层
    • Stdio（CLI 默认）
    • SSE（Web 集成）
    • REST API 端点

有关更详细的架构文档，请参阅ARCHITECTURE.md 。

技术亮点

高级搜索技术

  1. 向量归一化
    • 所有向量均标准化为单位长度（幅度 = 1）
    • 确保一致的余弦相似度计算
    • 通过关注方向而不是幅度来提高搜索精度
  2. 并行搜索执行
    • 向量搜索和文本搜索并行运行
    • 利用 Promise.all 实现最佳性能
    • 如果任一搜索失败，则启用回退机制
  3. 加权结果合并
    • 向量和文本结果之间的可配置权重
    • 默认值：向量相似度（70%），文本匹配（30%）

错误处理和日志系统

MCP Advisor 实现了强大的错误处理和日志系统：

  1. 上下文错误格式
    • 标准化错误对象丰富
    • 堆栈跟踪保存和格式化
    • 错误类型分类和标准化
  2. 优雅降级
    • 多提供商回退策略
    • 部分结果处理
    • 严重故障的默认响应

有关更多技术细节，请参阅TECHNICAL_DETAILS.md 。

开发人员快速入门

开发环境设置

  1. 克隆存储库
  2. 安装依赖项：
    npm install
  3. 配置环境变量（参见INSTALLATION.md ）

图书馆使用情况

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);

交通选择

MCP Advisor 支持多种传输方式：

  1. Stdio Transport （默认）- 适用于命令行工具
  2. SSE Transport - 适用于 Web 集成
  3. REST 传输- 提供 REST API 端点

有关更多开发详细信息，请参阅DEVELOPER_GUIDE.md 。

贡献指南

  1. 遵循提交消息约定：
    • 使用小写类型（feat、fix、docs 等）
    • 用句子格式写描述性信息
  2. 确保代码质量：
    • 运行测试： npm test
    • 检查类型： npm run type-check
    • Lint 代码： npm run lint

有关详细的贡献指南，请参阅CONTRIBUTING.md 。

使用示例

示例查询

以下是一些可以与 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"

示例响应

[ { "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 } ]

有关更多示例，请参阅EXAMPLES.md 。

故障排除

常见问题

  1. 连接被拒绝
    • 确保服务器在指定端口上运行
    • 检查防火墙设置
  2. 未返回结果
    • 尝试更通用的查询
    • 检查注册表 API 的网络连接
  3. 性能问题
    • 考虑添加更具体的搜索词
    • 检查服务器资源（CPU/内存）

有关更多故障排除信息，请参阅TROUBLESHOOTING.md 。

搜索提供商

MCP Advisor 支持多个可同时使用的搜索提供程序：

  1. Compass Search Provider ：使用 Compass API 检索 MCP 服务器信息
  2. GetMCP 搜索提供程序：使用 GetMCP API 和向量搜索进行语义匹配
  3. Meilisearch Search Provider ：使用 Meilisearch 进行快速、容错的文本搜索

有关搜索提供程序的详细信息，请参阅SEARCH_PROVIDERS.md 。

API 文档

有关详细的 API 文档，请参阅API_REFERENCE.md 。

路线图

MCP Advisor 正在从一个简单的推荐系统发展成为一个智能代理编排平台。我们的愿景是创建一个不仅能推荐合适的 MCP 服务器，还能从交互中学习，并帮助代理动态规划和执行复杂任务的系统。

主要发展阶段

  1. 推荐能力优化（2025年Q2-Q3）
    • 接受用户反馈
    • 优化推荐效果
    • 引入更多指数

有关详细路线图，请参阅ROADMAP.md 。

测试

使用检查器进行测试：

npx @modelcontextprotocol/inspector

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

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

How are these scores calculated?

hybrid server

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

一种发现和推荐服务，可帮助 AI 助手根据自然语言查询找到模型上下文协议服务器。

  1. 介绍
    1. 特征
      1. 文档导航
        1. 快速入门
          1. 安装
          2. 演示
        2. 开发者指南
          1. 架构概述
          2. 核心组件
        3. 技术亮点
          1. 高级搜索技术
          2. 错误处理和日志系统
        4. 开发人员快速入门
          1. 开发环境设置
          2. 图书馆使用情况
          3. 交通选择
        5. 贡献指南
          1. 使用示例
            1. 示例查询
            2. 示例响应
          2. 故障排除
            1. 常见问题
          3. 搜索提供商
            1. API 文档
              1. 路线图
                1. 主要发展阶段
              2. 测试
                1. 执照

                  Related MCP Servers

                  • WebSearch-MCP

                    mnhlt
                    A
                    security
                    F
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI assistants to perform real-time web searches, retrieving up-to-date information from the internet via a Crawler API.
                    Last updated -
                    1
                    44
                    8
                    JavaScript
                    • Apple
                    • Linux

                  • MCP Web Search Tool

                    gabrimatic
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that provides real-time web search capabilities to AI assistants through pluggable search providers, currently integrated with the Brave Search API.
                    Last updated -
                    3
                    TypeScript
                    MIT License

                  • CodeAlive MCPofficial

                    CodeAlive-AI
                    -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enhances AI agents by providing deep semantic understanding of codebases, enabling more intelligent interactions through advanced code search and contextual awareness.
                    Last updated -
                    40
                    Python
                    MIT License
                    • Apple

                  • MCPfinder Server

                    mcpfinder
                    A
                    security
                    A
                    license
                    A
                    quality
                    Enables AI assistants to discover, retrieve details about, and manage MCP (Model Context Protocol) servers that provide additional tools and capabilities on demand.
                    Last updated -
                    4
                    209
                    3
                    JavaScript
                    AGPL 3.0
                    • Linux
                    • Apple

                  View all related MCP servers

                  Appeared in Searches

                  New 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