MCP Advisor (Olaservo)

MCP顾问

⚠️警告：当前此服务器依赖于官方LLMS.txt文件，该文件不再与此服务器所需的格式匹配。此服务器还需要更新为最新规范。目前，我建议使用官方文档服务器，并指向MCP仓库中的模式。

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

我什么时候会使用这种类型的解决方案，而不是网络搜索或其他RAG解决方案？

虽然网络上已经有了相同的信息，但如果你有一个需要精确规格信息的用例，直接获取规格细节作为上下文应该会提供更可靠的结果。

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

做同样事情的其他方法

如果你喜欢一种更特殊的方法，你也可以使用MCP服务器，比如 获取 执行以下操作：

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

安装

# Install as a dependency
npm install mcp-advisor

# Or install globally to use the CLI
npm install -g mcp-advisor

用法

使用克劳德桌面

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

{
  "mcpServers": {
    "mcp-advisor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-advisor@latest"
      ],
      "env": {
        "DEFAULT_SPEC_VERSION":"2025-06-18" // Optional - overrides the default version used for static Resources that correspond to a specific MCP version
      }
    }
  }
}

1. 服务器提供以下功能：

提示

• 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规范和文档不同部分的访问：

规范资源

• 完整说明书：完整的模型上下文协议规范，包括模式、架构、基础协议、实用程序、服务器功能和客户端功能
• 架构规范：完整的模型上下文协议JSON模式规范
• 架构概述：模型上下文协议架构概述
• 基本协议：核心协议详细信息，包括传输、授权和生命周期
• 公用事业：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)：模型上下文协议的高级概述

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

发展

# Clone the repository
git clone https://github.com/olaservo/mcp-advisor.git
cd mcp-advisor

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build the project
npm run build

# Start the built server
npm start

测试URL过滤和版本支持

服务器包括URL过滤，以确保包含与请求版本匹配的内容：

npm run test

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

链接

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