MCP Advisor

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

在什么情况下我会选择这种解决方案而不是网络搜索或其他RAG解决方案？

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

由于这些资源应容易适应模型的上下文窗口，除非需要比较文档或进行更复杂的查询，否则使用更复杂的RAG解决方案并不是必要的。

其他实现相同目标的方法

如果你偏好一种临时的方法，也可以使用如fetch这样的MCP服务器来执行以下操作：

1. 获取https://modelcontextprotocol.io/llms.txt的内容以获得有效链接列表。
2. 从与当前任务相关的链接中获取内容。

安装

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

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

使用方法

与Claude Desktop一起使用

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

{
  "mcpServers": {
    "mcp-advisor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-advisor@latest"
      ],
      "env": {
        "DEFAULT_SPEC_VERSION":"2025-06-18" // 可选 - 覆盖用于特定MCP版本静态资源的默认版本
      }
    }
  }
}

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

提示

• explain: 对MCP主题进行全面解释，并提供完整的文档上下文。
  • 必需参数：topic - 指定你想详细了解的MCP主题。
  • 可选参数：version - 指定要使用的MCP规范版本。支持的版本：draft, 2024-11-05, 2025-03-26, 2025-06-18（默认）。
• evaluate_server_compliance: 评估给定服务器仓库的模型上下文协议（MCP）规范合规性。
  • 必需参数：path - 指定要评估的MCP服务器仓库路径。
  • 可选参数：version - 指定要使用的MCP规范版本。支持的版本：draft, 2024-11-05, 2025-03-26, 2025-06-18（默认）。

资源

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

规范资源

• 完整规范: 包括架构、基础协议、工具、服务器特性及客户端特性的完整模型上下文协议规范。
• 架构概述: 模型上下文协议架构概述。
• 基础协议: 包括传输、授权和生命周期的核心协议详情。
• 工具: 关于Ping、取消和进度报告功能的文档。
• 服务器特性: 包括完成、日志记录和分页在内的提示、资源、工具及服务器工具的综合指南。
• 客户端特性: 关于根节点和采样能力的信息。

所有规范资源都可以通过特定版本参数访问。

资源模板

该服务器提供了资源模板，允许访问不同版本的规范资源：

• https://modelcontextprotocol.io/specification/{version}/index.md: 访问任何支持版本的完整规范。
• https://modelcontextprotocol.io/specification/{version}/schema.json: 访问任何支持版本的JSON规范。
• https://modelcontextprotocol.io/specification/{version}/architecture/index.md: 访问任何支持版本的架构规范。
• https://modelcontextprotocol.io/specification/{version}/basic/index.md: 访问任何支持版本的基础协议规范。
• https://modelcontextprotocol.io/specification/{version}/basic/utilities/index.md: 访问任何支持版本的工具规范。
• https://modelcontextprotocol.io/specification/{version}/server/index.md: 访问任何支持版本的服务器特性规范。
• https://modelcontextprotocol.io/specification/{version}/client/index.md: 访问任何支持版本的客户端特性规范。

支持的版本：draft, 2024-11-05, 2025-03-26, 2025-06-18（默认）。

版本配置：

• 资源模板: 支持资源模板的客户端可以在URI模板中指定版本。
• 环境变量: 设置DEFAULT_SPEC_VERSION环境变量以更改默认版本（例如，DEFAULT_SPEC_VERSION=draft）。
• 默认版本: 如果未指定上述任何一项，服务器将使用2025-06-18作为默认版本。

关于向后兼容性: 仅支持资源（而非资源模板）的客户端仍能使用配置的默认版本访问常规资源。服务器完全兼容现有客户端。

附加文档资源

• 入门指南 (/quickstart): 针对客户端开发者、服务器开发者和用户的入门指南。
• 开发资源 (/development): 开发资源包括贡献指南、路线图和更新。
• SDK文档 (/sdk): 各种编程语言的SDK文档。
• 教程与示例 (/tutorials): 教程、示例和实施指南。
• 通用文档 (/docs): 包括常见问题解答、简介和客户端列表的通用文档。
• 社区文档 (/community): 社区指南包括SEP指南、沟通和治理。
• 入门指南 (/docs/getting-started): MCP的介绍和入门指南。
• 学习资源 (/docs/learn): 架构概述和核心概念。
• MCP调试工具 (/legacy/tools): 包括MCP检查器在内的调试工具。
• MCP概览 (/overview): 模型上下文协议的高层次概述。

所有规范内容都从a标准化的llms.txt文件提供的列表中获取（除了从GitHub获取的schema.json），并在本地缓存，缓存时间为1小时，以提高性能。如果获取失败，服务器将在有可用的情况下尝试使用已过期的缓存内容作为备用。

开发

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

# 安装依赖
npm install

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

# 构建项目
npm run build

# 启动构建的服务器
npm start

测试URL过滤和版本支持

服务器包括URL过滤以确保包含符合请求版本的内容：

npm run test

这验证了服务器是否正确地根据请求的版本过滤规范URL。服务器支持多个版本，包括draft, 2024-11-05, 2025-03-26和2025-06-18，其中2025-06-18是未指定版本时的默认值。

链接

• 模型上下文协议规范（支持多个版本）