MCP Advisor

MCP Advisor

English | 简体中文

MCP Advisor 可帮助 MCP 客户端根据任务发现服务，并获取安装指导。它聚合多个搜索提供方并返回推荐结果；不会替你安装服务、编辑客户端配置，也不会验证推荐服务是否安全。

从这里开始

1. **使用当前源码：**按照 快速入门 配置 MCP 2026-07-28 客户端、stdio 或 HTTP。
2. **需要兼容旧版客户端？**已发布的 npm 版本 1.0.5 是单独的旧版发行版。不要将当前源码的传输配置用于该版本。
3. **进行开发或诊断：**阅读贡献指南、架构说明和技术参考。若遇到当前协议故障，请从迁移指南开始排查。

获奖情况与项目背景

MCP Advisor 由 mcpadvisor 团队开发。该团队在 2025 年首届 OceanBase AI 黑客松大赛中获得二等奖。 主办方 5 月 19 日的活动报道提到了该团队，并介绍了其 MCP 搜索与推荐项目；活动于 2025 年 5 月 17 日在广州结束。 作者在 OceanBase 社区发布的帖子说明了该项目与此代码仓库的关联。这是历史性认可，并非基准测试结果，也不代表对当前所有功能的认可。

提供哪些功能？

能力	当前源码状态
recommend-mcp-servers	基于任务的推荐，可选关键词／能力
install-mcp-server	仅提供安装指导／配置文本；不会自动安装
Meilisearch、Compass、GetMCP	由 CLI 构建；仍取决于外部服务是否可用及其配置
离线提供方	默认由 SearchService 启用；嵌入可能需要下载模型
Nacos 发现	可选启用；CLI 需要地址、用户名和密码
Cline Marketplace	已实现，通过 CLINE_MARKETPLACE_ENABLED=true 可选启用
FlashRank 重排序	已实现，默认关闭；需要单独启动 Python 服务并配置模型
搜索质量评估	评估工具和示例数据；不能证明生产环境中的质量
自动安装／质量保证	未实现／尚未确立

当前启用的 Meilisearch 提供方使用文本搜索。离线检索结合文本和向量；这并非通用向量搜索、动态查询权重调整，也不保证返回五条结果。在线提供方仍会与离线数据同时运行。

选择运行方式

当前源码（现代协议）

应用需要 Node.js 20+；Inspector 2.10.1 还需要 Node.js 22.19+。请使用 package.json 中固定的 pnpm 8.15.9。

git clone https://github.com/istarwyh/mcpadvisor.git
cd mcpadvisor
corepack enable
pnpm install --frozen-lockfile
pnpm run build
node build/index.js

默认使用 stdio。诊断信息不得输出到 stdout。如需使用本地 HTTP：

TRANSPORT_TYPE=http SERVER_HOST=127.0.0.1 SERVER_PORT=3000 node build/index.js

将兼容的 MCP 2026-07-28 客户端连接到 http://127.0.0.1:3000/mcp。 参见官方 SDK 客户端示例。 HTTP 是无状态的，每个请求都会创建一个新的协议服务；提供方缓存可以在进程范围内保留。旧版 SSE／REST 模式会被拒绝，旧版 HTTP 路径会返回 410。现代 POST 响应仍可能使用 SSE 编码。没有内置身份验证或面向跨源浏览器请求的 CORS：除非你提供独立保护的网关，否则请保持绑定到环回地址。能够托管并不代表已获准接入。

已发布的 npm 1.0.5（旧版）

npx -y @xiaohui-wang/[email protected]

这会选择较早发布的制品，而不是上面的源码。请确认该版本自身的客户端兼容性和配置。源码检出版本仍声明为 1.0.5，并不意味着这些源码变更已发布到 npm。

第三方安装程序

Marketplace/Smithery 列表及其安装程序由各自的维护者独立维护。 运行前请检查所选制品/版本、权限和传输方式。本指南不保证它们提供的是当前的现代源代码。

配置和扩展

CLI 不会读取 SEARCH_PROVIDER、SEARCH_LIMIT 或 SEARCH_MIN_SIMILARITY。Provider 注入和 SearchOptions 属于 编程式 SearchService API，而不是虚构的环境变量。 请勿从 npm 根目录导入 SearchService：该软件包入口是 CLI，带有 启动副作用。参见源代码检出 API 示例。

主题	指南
CLI、HTTP、Nacos 凭据和编程式选项	快速入门
本地 Meilisearch 生命周期	本地 Meilisearch
文本搜索行为	全文搜索
可选的 Cline 源	Cline Marketplace
可选的本地模型服务、故障回退和隐私	FlashRank
评判结果、指标和示例数据的限制	搜索质量评估
Inspector 前置条件和针对性浏览器检查	Inspector UI 测试
现代协议和回滚边界	MCP 迁移
较早的运维诊断	故障排查

与托管相关的故障排查修订单独记录在 PR #40 中；当前传输行为请参阅 迁移指南。本说明不包含任何尚未合并的托管配置。

验证更改

pnpm run check
pnpm test
pnpm run build
pnpm run test:protocol

这些命令分别涵盖 lint/格式检查、Vitest、生产环境编译，以及针对性的离线 协议/启动检查。它们无法证明实时 Provider 是否可用，也无法证明排序质量。 Playwright 汇总测试套件为 pnpm run test:e2e （scripts/e2e/e2e.run.sh）；运行该套件需要满足文档中列出的浏览器/服务前置条件。 单个 Inspector 测试规格不等同于汇总测试套件。参见 贡献指南和Inspector UI 测试。

项目方向和文档

路线图保留的是历史计划，而非当前交付日期。 Cline 和 FlashRank 是已实现的可选功能，不是尚待实现的 TODO。 新的 Provider 集成、质量声明和部署工作需要各自明确范围并提供证据。

文档审查记录说明了 源代码基线、验证边界和语言镜像政策。 欢迎通过 issue 和有针对性且经过测试的拉取请求贡献内容。