MCP Everything

🚀 MCP 萬能服務器

本項目從 https://github.com/modelcontextprotocol/servers/tree/main/src/everything 提取而來，旨在創建一個獨立的實現。這個 MCP 服務器展示了 MCP 協議的所有功能，它並非實用型服務器，而是為測試 MCP 客戶端構建者而創建的演示服務器，實現了提示、工具、資源、採樣等功能，充分展現了 MCP 的能力。

🚀 快速開始

注意事項

⚠️ 重要提示

該項目是從 https://github.com/modelcontextprotocol/servers/tree/main/src/everything 提取出來的，以創建一個獨立的實現。

📦 安裝指南

本地安裝

# 克隆倉庫
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 (字符串)：需要回顯的消息。
   • 返回：包含回顯消息的文本內容。

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)：是否包含示例圖像。
   • 返回：帶有註釋的消息內容。

資源

• 資源分類：包含 100 個測試資源，分為兩類：
  • 偶數編號：文本類型資源。
  • 奇數編號：二進制 blob 類型資源。
• 支持功能：
  • 分頁瀏覽。
  • 資源訂閱和更新通知。

提示

• 提示模板：包含兩個提示模板：
  • 簡單提示：基本的單輪對話提示。
  • 複雜提示：需要參數 (如溫度) 和可選風格的多輪對話提示。

日誌

• 日誌功能：每隔 15 秒發送一條隨機級別的日誌消息，用於測試客戶端的日誌接收能力。