MCP Everything

注意： 本项目提取自 https://github.com/modelcontextprotocol/servers/tree/main/src/everything，旨在创建一个独立的实现。

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

安装

本地安装

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

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务器
npm start

全局安装

# 从 npm 全局安装
npm install -g mcp-everything

# 运行服务器
mcp-everything

Docker

# 构建 Docker 镜像
docker build -t mcp-everything .

# 运行容器
docker run -it mcp-everything

与 Claude Desktop 一起使用

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-everything"
      ]
    }
  }
}

组件

工具

1. echo

   • 简单的工具，用于回显输入消息
   • 输入：
     • message (string): 要回显的消息
   • 返回：包含回显消息的文本内容

2. add

   • 将两个数字相加
   • 输入：
     • a (number): 第一个数字
     • b (number): 第二个数字
   • 返回：加法运算的文本结果

3. longRunningOperation

   • 演示长时间运行操作的进度通知
   • 输入：
     • duration (number, 默认值: 10): 持续时间，以秒为单位
     • steps (number, 默认值: 5): 进度步数
   • 返回：包含持续时间和步数的完成消息
   • 在执行期间发送进度通知

4. sampleLLM

   • 演示使用 MCP 采样功能的 LLM 采样能力
   • 输入：
     • prompt (string): 发送到 LLM 的提示
     • maxTokens (number, 默认值: 100): 要生成的最大 token 数
   • 返回：生成的 LLM 响应

5. getTinyImage

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

6. printEnv

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

7. annotatedMessage

   • 演示如何使用注释来提供有关内容的元数据
   • 输入：
     • messageType (enum: "error" | "success" | "debug"): 要演示的不同注释模式的消息类型
     • includeImage (boolean, 默认值: false): 是否包含示例图像
   • 返回：具有不同注释的内容

资源

服务器提供 100 个测试资源，格式如下：

• 偶数编号的资源：

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

• 奇数编号的资源：

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

资源特性：

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

提示

1. simple_prompt

   • 没有参数的基本提示
   • 返回：单个消息交换

2. complex_prompt

   • 演示参数处理的高级提示
   • 必需参数：
     • temperature (number): 温度设置
   • 可选参数：
     • style (string): 输出样式偏好
   • 返回：包含图像的多轮对话

日志记录

服务器每 15 秒发送随机级别的日志消息，以演示 MCP 的日志记录功能。