mcp/everything Docker Image

Everything (参考版) MCP 服务器

1. 概述

1.1 镜像简介

Everything (Reference) MCP Server 是一个参考/测试用 MCP 服务器，提供提示词、资源和工具集，主要用于 MCP (Model Context Protocol) 相关功能的开发、测试与验证。

1.2 MCP Server 说明

MCP（模型上下文协议）是用于简化 AI 应用构建的协议标准。https://www.anthropic.com/news/model-context-protocol

2. 核心特性

2.1 基础信息

2.2 工具集

服务器提供以下工具，支持各类 MCP 功能测试：

2.3 安全特性

• 支持镜像签名验证，确保镜像完整性
• 提供 Docker Scout 健康评分，反映镜像安全状态

3. 使用场景

• MCP 客户端开发测试：作为标准参考服务器，验证客户端与 MCP 协议的兼容性
• 工具功能验证：测试各类工具（如加法运算、LLM 采样、长运行操作）的调用流程与结果
• 环境配置调试：通过 printEnv 工具检查服务器环境变量配置
• 协议功能演示：展示 MCP 协议的注解、资源引用、进度更新等核心能力

4. 使用方法

4.1 快速启动

通过 Docker 命令直接运行服务器：

bash
docker run -i --rm docker.xuanyuan.run/mcp/everything

参数说明：

• -i：以交互模式运行，支持输入输出交互
• --rm：容器退出后自动删除，避免残留资源

4.2 Docker Compose 配置

创建 docker-compose.yml 文件，定义服务：

yaml
version: '3.8'
services:
  mcp-everything:
    image: docker.xuanyuan.run/mcp/everything
    stdin_open: true  # 等同于 -i 参数，保持标准输入打开
    tty: true         # 分配伪终端，支持交互
    restart: "no"     # 退出后不自动重启

启动服务：

bash
docker-compose up

4.3 MCP 客户端配置

在 MCP 客户端配置文件中引用该服务器（示例 JSON 配置）：

json
{
  "mcpServers": {
    "everything": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/everything"
      ]
    }
  }
}

5. 工具详情

5.1 add

功能：两数相加
参数说明：

5.2 annotatedMessage

功能：演示如何使用注解提供内容元数据
参数说明：

5.3 echo

功能：回显输入内容
参数说明：

5.4 getResourceReference

功能：返回 MCP 客户端可使用的资源引用
参数说明：

5.5 getTinyImage

功能：返回 MCP_TINY_IMAGE 资源
参数：无

5.6 longRunningOperation

功能：演示带进度更新的长运行操作
参数说明：

5.7 printEnv

功能：打印所有环境变量，用于调试 MCP 服务器配置
参数：无

5.8 sampleLLM

功能：使用 MCP 采样功能从 LLM 生成内容
参数说明：

6. 镜像验证

通过 Cosign 工具验证镜像签名，确保镜像未被篡改：

bash
COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/everything --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub

7. 许可证

本镜像基于 https://opensource.org/licenses/MIT 开源，允许自由使用、修改和分发。