Everything MCP Server

此MCP服务器旨在展示MCP协议的所有功能。它不是一个有用的服务器，而是用于测试MCP客户端构建者的测试服务器。它实现了提示、工具、资源、采样等功能，以展示MCP的能力。

组件

工具

1. echo

   • 简单工具，回显输入的消息
   • 输入：
     • message（字符串）：要回显的消息
   • 返回：包含回显消息的文本内容

2. add

   • 将两个数字相加
   • 输入：
     • a（数字）：第一个数字
     • b（数字）：第二个数字
   • 返回：加法结果的文本

3. longRunningOperation

   • 展示长时间操作的进度通知
   • 输入：
     • duration（数字，默认值：10）：持续时间（秒）
     • steps（数字，默认值：5）：进度步骤数
   • 返回：完成消息，包含持续时间和步骤数
   • 在执行过程中发送进度通知

4. printEnv

   • 打印所有环境变量
   • 用于调试MCP服务器配置
   • 不需要输入
   • 返回：所有环境变量的JSON字符串

5. sampleLLM

   • 使用MCP采样功能展示LLM采样能力
   • 输入：
     • prompt（字符串）：发送给LLM的提示
     • maxTokens（数字，默认值：100）：生成的最大标记数
   • 返回：生成的LLM响应

6. getTinyImage

   • 返回一个小的测试图像
   • 不需要输入
   • 返回：Base64编码的PNG图像数据

7. annotatedMessage

   • 展示如何使用注解提供关于内容的元数据
   • 输入：
     • messageType（枚举："error" | "success" | "debug"）：演示不同注解模式的消息类型
     • includeImage（布尔，默认值：false）：是否包含示例图像
   • 返回：带有不同注解的内容：
     • 错误消息：高优先级（1.0），对用户和助手可见
     • 成功消息：中等优先级（0.7），面向用户
     • 调试消息：低优先级（0.3），面向助手
     • 可选图像：中等优先级（0.5），面向用户
   • 示例注解：

     {
       "priority": 1.0,
       "audience": ["user", "assistant"]
     }
     

8. getResourceReference

   • 返回一个可以由MCP客户端使用的资源引用
   • 输入：
     • resourceId（数字，1-100）：要引用的资源ID
   • 返回：一个资源引用，包含：
     • 文本介绍
     • 嵌入资源，类型为 "resource"
     • 使用资源URI的文本说明

9. startElicitation

   • 在MCP客户端内启动一个交互（激发）。
   • 输入：
     • color（字符串）：最喜欢的颜色
     • number（数字，1-100）：最喜欢的数字
     • pets（枚举）：最喜欢的宠物
   • 返回：确认激发演示及其选择摘要。

10. structuredContent

• 展示一个工具返回结构化内容，使用规范中的示例
• 提供输出模式，允许测试客户端应建议使用模式验证结果
• 输入：
  • location（字符串）：一个位置或邮政编码，无论值为何都会返回模拟数据
• 返回：一个响应，包含：
  • 符合输出模式的 structuredContent 字段
  • 向后兼容的文本内容字段，规范中的应建议

11. listRoots

• 列出当前由客户端提供的MCP根目录
• 即使该服务器不访问文件，也展示了根目录协议的能力
• 不需要输入
• 返回：当前根目录列表及其URIs和名称，或者如果没有设置根目录，则返回一条消息
• 展示服务器如何与MCP根目录协议进行交互

资源

服务器提供了两种格式的100个测试资源：

• 偶数编号的资源：

  • 纯文本格式
  • URI模式：test://static/resource/{even_number}
  • 内容：简单的文本描述

• 奇数编号的资源：

  • 二进制blob格式
  • URI模式：test://static/resource/{odd_number}
  • 内容：Base64编码的二进制数据

资源特性：

• 支持分页（每页10项）
• 允许订阅资源更新
• 展示资源模板
• 每5秒自动更新已订阅的资源

提示

1. simple_prompt

   • 不带参数的基本提示
   • 返回：单次消息交换

2. complex_prompt

   • 高级提示，展示参数处理
   • 必需参数：
     • temperature（字符串）：温度设置
   • 可选参数：
     • style（字符串）：输出风格偏好
   • 返回：多轮对话，包含图像

3. resource_prompt

   • 展示在提示中嵌入资源引用
   • 必需参数：
     • resourceId（数字）：要嵌入的资源ID（1-100）
   • 返回：多轮对话，包含嵌入的资源引用
   • 展示如何直接在提示消息中包含资源

根目录

服务器展示了MCP根目录协议的能力：

• 声明 roots: { listChanged: true } 能力，表示支持根目录
• 处理来自客户端的 roots/list_changed 通知
• 在服务器初始化期间请求初始根目录
• 提供 listRoots 工具来显示当前根目录
• 记录与根目录相关的事件以供演示

注意：此服务器实际上并不访问文件，但展示了服务器如何与根目录协议进行交互，以便客户端理解哪些目录可用于文件操作。

日志

服务器每隔15秒发送随机级别的日志消息，例如：

{
  "method": "notifications/message",
  "params": {
	"level": "info",
	"data": "信息级别消息"
  }
}

使用Claude Desktop（使用stdio传输）

在您的 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

使用VS Code

快速安装，请使用下面的一个一键安装按钮...

手动安装时，您可以使用以下方法之一配置MCP服务器：

方法1：用户配置（推荐） 将配置添加到您的用户级MCP配置文件中。打开命令面板（Ctrl + Shift + P）并运行 MCP: 打开用户配置。这将打开您的用户 mcp.json 文件，在其中您可以添加服务器配置。

方法2：工作区配置 或者，您可以在工作区中的 .vscode/mcp.json 文件中添加配置。这将允许您与其他人员共享配置。

关于VS Code中MCP配置的更多详细信息，请参阅官方VS Code MCP文档。

NPX

{
  "servers": {
    "everything": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-everything"]
    }
  }
}

从源代码运行（使用HTTP+SSE传输（截至2025-03-26已弃用））

cd src/everything
npm install
npm run start:sse

从源代码运行（使用可流式传输的HTTP传输）

cd src/everything
npm install
npm run start:streamableHttp

作为已安装包运行

安装

npm install -g @modelcontextprotocol/server-everything@latest

运行默认（stdio）服务器

npx @modelcontextprotocol/server-everything

或明确指定stdio

npx @modelcontextprotocol/server-everything stdio

运行SSE服务器

npx @modelcontextprotocol/server-everything sse

运行可流式传输的HTTP服务器

npx @modelcontextprotocol/server-everything streamableHttp