MCP Sse Sample

🚀 MCP SSE 示例

本项目是使用SSE（Server-Sent Events）实现的MCP服务器示例，清晰展示了MCP协议中SSE的具体实现方法。

✨ 主要特性

• 提供多种实用工具，涵盖消息回显、数字相加、长操作进度通知、LLM采样、图像获取、环境变量打印以及注释消息展示等功能。
• 服务器会定期发送随机级别的日志消息，方便调试与监控。

📦 安装指南

本地运行

# 安装依赖
npm install

# 构建项目
npm run build

# 以STDIO模式运行
npm run start

# 以SSE模式运行
npm run start:sse

在Claude Desktop中使用

在claude_desktop_config.json文件中添加以下配置：

{
  "mcpServers": {
    "sse-sample": {
      "command": "npx",
      "args": [
        "-y",
        "mcp_sse_sample"
      ]
    }
  }
}

📚 详细文档

组件

工具

1. echo

   • 功能：简单的回显工具，可将输入的消息原样返回。
   • 输入参数：
     • message (字符串)：需要回显的消息内容。
   • 返回结果：包含回显消息的文本内容。

2. add

   • 功能：实现两个数字的相加操作。
   • 输入参数：
     • a (数字)：第一个相加的数字。
     • b (数字)：第二个相加的数字。
   • 返回结果：相加结果的文本。

3. longRunningOperation

   • 功能：模拟长操作，并在执行过程中发送进度通知。
   • 输入参数：
     • duration (数字, 默认值为10)：操作的持续时间（单位：秒）。
     • steps (数字, 默认值为5)：进度步骤的数量。
   • 返回结果：完成消息，包含操作的持续时间和步骤数。
   • 执行过程：在操作执行过程中会发送进度通知。

4. sampleLLM

   • 功能：利用MCP采样功能演示LLM的采样能力。
   • 输入参数：
     • prompt (字符串)：发送给LLM的提示信息。
     • maxTokens (数字, 默认值为100)：最大生成的令牌数。
   • 返回结果：LLM生成的响应内容。

5. getTinyImage

   • 功能：返回一个小测试图像。
   • 输入参数：无。
   • 返回结果：Base64编码的PNG图像数据。

6. printEnv

   • 功能：打印所有环境变量，用于调试MCP服务器配置。
   • 输入参数：无。
   • 返回结果：所有环境变量的JSON字符串。

7. annotatedMessage

   • 功能：展示如何使用注释为内容提供元数据。
   • 输入参数：
     • messageType (枚举: "error" | "success" | "debug")：要展示的不同消息类型。
     • includeImage (布尔值, 默认值为false)：是否包含示例图像。
   • 返回结果：具有不同注释的内容：
     • 错误消息：高优先级（1.0），用户和助理都可见。
     • 成功消息：中等优先级（0.7），面向用户。
     • 调试消息：低优先级（0.3），面向助理。
     • 可选图像：中等优先级（0.5），面向用户。
   • 示例注释：

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

日志

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

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Info-level message"
  }
}