使用说明

MCP Advisor 是一个基于 Model Context Protocol (MCP) 的服务器，专注于帮助 AI 助手或任何 MCP 客户端发现和利用其他 MCP 服务器所提供的工具。通过自然语言查询，MCP Advisor 能够搜索互联网上已知的 MCP 服务器注册表和内部数据源，找到与用户需求匹配的服务，并提供详细信息甚至安装指导。

主要功能点

自然语言搜索： 使用日常语言描述您需要的服务或功能，MCP Advisor 将为您查找相关的 MCP 服务器。
服务推荐： 根据查询意图，智能推荐最匹配的 MCP 服务器及其工具。
丰富元数据： 提供找到的服务器的名称、描述、GitHub 地址等详细信息。
安装指南： 可以获取特定 MCP 服务器的安装步骤指导。
多种传输协议： 支持 Stdio、SSE 和 REST 等协议，方便与不同类型的客户端集成。

安装步骤

MCP Advisor 是一个 Node.js 应用，可以通过 npm 或 npx 方便地安装和运行。

确保已安装 Node.js 和 npm/yarn/pnpm： 如果未安装，请先安装 Node.js。

通过 npm 全局安装（可选）：

npm install -g @xiaohui-wang/mcpadvisor

安装后即可通过命令行 'mcpadvisor' 启动。

通过 npx 临时运行（推荐用于集成）： npx 允许您直接运行远程 npm 包而无需提前安装。这通常是 AI 助手集成 MCP 服务器的推荐方式。

服务器配置（供MCP客户端参考）

MCP Advisor 通常作为本地进程由 MCP 客户端按需启动。客户端需要知道如何执行 MCP Advisor 可执行文件。这个信息在客户端的 MCP 配置中指定，通常是一个 JSON 文件。

配置示例片段（客户端配置文件的 'mcpServers' 部分）：

{
  // ... 其他配置 ...
  "mcpServers": {
    // 'mcpadvisor' 是您给这个服务器取的名字，供客户端内部使用
    "mcpadvisor": {
      // 'command' 指定要运行的可执行文件或命令
      "command": "npx", 
      // 'args' 提供传递给命令的参数，这里用来执行 npm 包
      "args": ["-y", "@xiaohui-wang/mcpadvisor"] 
    }
  }
  // ... 其他配置 ...
}

将类似上述配置添加到您的 MCP 客户端（如 Claude Desktop）的配置文件中。例如：

macOS/Linux: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%AppData%\Claude\claude_desktop_config.json'

配置完成后，客户端启动时将能够根据这个配置启动 MCP Advisor 并通过 MCP 协议与其通信。

基本使用方法

MCP Advisor 的功能通过 工具 (Tools) 向 MCP 客户端暴露。主要工具包括：

'recommend-mcp-servers': 用于根据自然语言查询推荐 MCP 服务器。
- 如何使用（客户端调用此工具）： 客户端会调用此工具，并传递一个包含用户查询的参数，例如 '{"query": "我需要一个处理金融数据的MCP服务器"}'。
- 期望结果： MCP Advisor 会返回一个列表，包含它认为最相关的 MCP 服务器的信息（名称、描述、GitHub 地址、匹配度等）。
'install-mcp-server': 用于获取特定 MCP 服务器的安装指南。
- 如何使用（客户端调用此工具）： 客户端会调用此工具，并传递要安装的 MCP 名称和其 GitHub URL，例如 '{"mcpName": "Financial Analytics MCP", "githubUrl": "https://github.com/example/financial-mcp"}'。
- 期望结果： MCP Advisor 会尝试从 GitHub README 中提取安装部分，或生成一个通用的安装指南，然后将其返回给客户端。

普通用户通常无需直接与 MCP Advisor 命令行交互，而是通过支持 MCP 协议的 AI 助手或其他客户端来透明地使用它。

关键词

使用说明

主要功能点

安装步骤

服务器配置（供MCP客户端参考）

基本使用方法

信息