/ 目錄 / 演練場 / Everything (test server)
● 官方 modelcontextprotocol ⚡ 即開即用

Everything (test server)

作者 modelcontextprotocol · modelcontextprotocol/servers

MCP 參考測試伺服器 — 所有協議功能匯集一處。用於調試你的 MCP 客戶端,不用於生產環境。

參考『萬能』伺服器。暴露所有 MCP 功能:工具(同步和長時間執行)、資源(靜態和動態)、提示、取樣、完成。用它確認你的 MCP 客戶端實作能運作,或教/學協議。不用於實際工作流程。

為什麼要用

核心特性

即時演示

實際使用效果

everything.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "everything": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "everything",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-everything"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "everything": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-everything"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add everything -- npx -y @modelcontextprotocol/server-everything

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: Everything (test server)

驗證你的 MCP 客戶端實作處理每個協議功能

👤 正在構建或調試 MCP 客戶端、SDK 或整合的開發者 ⏱ ~20 min intermediate

何時使用: 你正在推出新的 MCP 客戶端、整合或包裝層,並想證明它在指向真實伺服器前能處理工具+資源+提示+取樣。

前置條件
  • 你的 MCP 客戶端測試中 — Claude Desktop、你的自訂客戶端或測試框架
步驟
  1. 啟動 everything 伺服器並列出其功能
    連接到 everything 伺服器。列出它暴露的每個工具、資源和提示。✓ 已複製
    → 完整清單 — 確認你的客戶端可以發現完整介面
  2. 練習每個功能
    呼叫 echo,然後 add,然後 longRunningOperation(10 秒期間)。讀取靜態資源和動態資源。調用 simple_prompt 提示。✓ 已複製
    → 每個呼叫完成或正確串流;取消有效
  3. 測試邊界情況
    試試取樣(sampleLLM 工具)、提示參數的完成和刻意錯誤的工具。檢查你的客戶端處理每個路徑。✓ 已複製
    → 沒有當機;錯誤使用適當的 MCP 錯誤碼顯示

結果: 你的客戶端實際實作的 MCP 功能的核對矩陣,附帶證據。

注意事項
  • 並非所有客戶端都實作取樣 — 取樣是客戶端選用;如果你的不支援,sampleLLM 工具將顯示清晰的錯誤 — 預期的,不是 bug

透過在真實伺服器上戳來學習 MCP 協議

👤 對 MCP 不熟悉但已讀過規格並想看到實際運作的開發者 ⏱ ~45 min intermediate

何時使用: 你在研究協議並想要一個你也可以並排閱讀原始程式碼的伺服器。

步驟
  1. 以 stdio 傳輸執行伺服器並監看流量
    執行 npx -y @modelcontextprotocol/server-everything 並連接客戶端。擷取 JSON-RPC 交換(工具列表、呼叫、回應)。✓ 已複製
    → 你可以對應到規格的原始協議框
  2. 讀取對應的原始程式碼
    開啟 modelcontextprotocol/servers/src/everything — 追蹤哪個檔案實作了你剛看到的工具、資源、提示處理程式。✓ 已複製
    → 線路協議和伺服器程式碼之間的 1:1 對應
  3. 修改並測試
    Fork 伺服器,新增返回目前伺服器正常運行時間的新工具,重新啟動並呼叫它。✓ 已複製
    → 你的新工具出現在 list_tools 中並回應呼叫

結果: 你在線路層級理解 MCP,不只是 SDK 層級。

注意事項
  • 將 everything-server 功能視為生產就緒模式 — 伺服器刻意為測試而過度功能化;真實伺服器應只暴露你實際需要的工具
搭配使用: fastmcp

組合

與其他 MCP 搭配,撬動十倍槓桿

everything + fastmcp

測試你的 FastMCP 構建伺服器表現得像參考

連接到我的 FastMCP 伺服器和 everything 伺服器。對於 everything 伺服器暴露的每個功能,檢查我的伺服器是否等效處理。✓ 已複製
everything + mcp-agent

針對具有已知行為的伺服器執行代理評估

設定指向 everything 伺服器的 mcp-agent。執行驗證工具呼叫、資源讀取和提示調用流程的測試套件。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
echo message: str 冒煙測試:確認請求/回應有效 free
add a: number, b: number 簡單的型別輸入測試 free
longRunningOperation duration: int (seconds), steps: int 在你的客戶端中測試串流/進度 + 取消路徑 free
sampleLLM prompt: str, maxTokens: int 測試 MCP 取樣功能 — 伺服器要求客戶端執行 LLM 呼叫 depends on client's sampling backend
getTinyImage none 測試二進位資源傳遞 free
printEnv none 診斷你的 MCP 客戶端傳遞哪些環境變數 free
annotatedMessage messageType: str, includeImage: bool 測試已註解內容的呈現(優先順序、觀眾) free

成本與限制

運行它的成本

API 配額
無 — 完全本地
每次呼叫 Token 數
微小
費用
免費
提示
唯一關切:longRunningOperationsampleLLM 可能在你的客戶端 LLM 上耗費真實時間或代幣;保持測試執行簡短。

安全

權限、密鑰、影響範圍

憑證儲存:
資料出站: 預設為無;printEnv 暴露你的客戶端傳遞的任何環境變數 — 演示時不要指向包含祕密的程序

故障排查

常見錯誤與修復

連接後客戶端不顯示任何工具

確認 stdio 傳輸相符。某些客戶端要求伺服器程序長時間執行;檢查你的客戶端『命令』設定在不退出的情況下執行。

驗證: Run `npx -y @modelcontextprotocol/server-everything` directly; it should block waiting for input
sampleLLM 傳回『不支援取樣』

你的客戶端不實作 MCP 取樣(很多沒有)。今天大多數客戶端都預期如此。跳過該工具。

longRunningOperation 不串流進度

你的客戶端可能沒有訂閱進度通知。檢查其檔案的進度處理程式支援。

替代方案

Everything (test server) 對比其他方案

替代方案何時用它替代權衡
FastMCP你想構建你自己的測試伺服器,而不是使用參考更多工作;讓你隔離特定行為
任何真實伺服器(github、filesystem 等)你想針對現實、狹義的工具表面測試,而不是廚房洗水槽較小的介面 — 可能會錯過你的客戶端需要支援的功能

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills