MCP Advisor

一个 MCP 服务器，通过提示和资源提供对模型上下文协议规范的全面访问。该服务器通过提供完整的 JSON 模式和详细的文档，帮助 LLM 和人类理解和使用 MCP 规范。

何时使用这种类型的解决方案而不是网络搜索或其他 RAG 解决方案？

虽然相同的信息已经在网络上可用，但如果您有需要精确规范信息的用例，直接获取规范详细信息作为上下文应该提供更可靠的结果。

由于这些资源应该很容易适应模型的上下文窗口，因此除非您需要将文档与其他文档进行比较，或者进行更复杂的查询类型，否则实际上没有必要使用更复杂的 RAG 解决方案。

安装

# 作为依赖项安装
npm install mcp-advisor

# 或者全局安装以使用 CLI
npm install -g mcp-advisor

用法

与 Claude Desktop 一起使用

1. 将以下内容添加到您的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "mcp-advisor": {
      "command": "npx",
      "args": [
        "mcp-advisor@latest"
      ]
    }
  }
}

2. 该服务器提供以下功能：

提示

• explain: 对 MCP 主题的全面解释，包含完整的文档上下文。 需要一个 topic 参数，指定您希望详细解释的 MCP 主题。

资源

该服务器提供对 MCP 规范文档不同部分的访问：

• 完整规范 (/specification/complete): 完整的模型上下文协议规范，包括模式、架构、基本协议、实用程序、服务器功能和客户端功能
• 模式规范 (/specification/schema): 完整的模型上下文协议 JSON 模式规范 (2025-03-26)
• 架构概述 (/specification/basic/architecture): 模型上下文协议架构概述
• 基本协议 (/specification/basic): 核心协议详细信息，包括传输、授权和生命周期
• 实用程序 (/specification/utilities): Ping、取消和进度报告功能的文档
• 服务器功能 (/specification/server): Prompts、Resources、Tools 和 Server Utilities 的综合指南，包括完成、日志记录和分页
• 客户端功能 (/specification/client): 有关 Roots 和 Sampling 功能的信息

从 GitHub 获取的所有规范内容都缓存在本地，TTL（生存时间）为 1 小时，以提高性能并减少 API 调用。 如果获取失败，服务器将尝试在可用时使用过期的缓存内容作为后备。

开发

# 克隆存储库
git clone https://github.com/olaservo/mcp-advisor.git
cd mcp-advisor

# 安装依赖
npm install

# 在开发模式下运行
npm run dev

# 构建项目
npm run build

# 启动构建的服务器
npm start

链接

• 模型上下文协议规范