MCP Server Server

🚀 mcp-server-server

此倉庫是一個 MCP 服務器的概念驗證實現，通過 WebSocket 將另一個基於標準輸入輸出 (stdio) 的 MCP 服務器對外暴露。藉助該實現，能更便捷地管理和使用 MCP 服務器，解決了傳統方式下管理複雜、啟動緩慢等問題。

🚀 快速開始

第一步：將現有的 stdio MCP 服務器轉換為 WebSocket MCP 服務器

此倉庫包含一個包裝程序，可將現有的 MCP 服務器（此處 列出了一些官方的服務器）通過 WebSocket 暴露出來。

bun run mcp-server-wrapper -p 3001 -- npx -y @modelcontextprotocol/server-puppeteer@latest

為了更快的啟動時間，可直接使用 node 安裝並運行：

pnpm install -g @modelcontextprotocol/server-puppeteer@latest
bun run mcp-server-wrapper -p 3001 -- node ~/Library/pnpm/global/5/node_modules/@modelcontextprotocol/server-puppeteer/dist/index.js

第二步：無需管理進程即可程序化地與 MCP 服務器交互

基礎用法

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";

const transport = new WebSocketClientTransport(new URL("ws://localhost:3001"));

const client = new Client(
  {
    name: "example-client",
    version: "1.0.0",
  },
  {
    capabilities: {},
  }
);
await client.connect(transport);
const tools = await client.listTools();
console.log(
  "Tools:", 
  tools.tools.map((t) => t.name)
);
await client.close();

運行示例

bun run mcp-server-wrapper-client
$ bun run src/mcp-server-wrapper/example-client/example-client.ts
Tools: [ "puppeteer_navigate", "puppeteer_screenshot", "puppeteer_click", "puppeteer_fill",
  "puppeteer_evaluate"
]

第三步：將其打包到 Docker 鏡像中

對於給定的 MCP 服務器配置，例如：

{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

我們希望為這種 MCP 服務器配置生成一個 Docker 鏡像，以便在任何地方運行。此倉庫包含了一個腳本，該腳本將根據 MCP 服務器配置輸出一個 Dockerfile：

# 這裡應該有一個示例命令，但當前文檔中沒有提供具體的命令。

✨ 主要特性

解決傳統 MCP 服務器使用難題

使用 MCP 服務器往往困難重重，傳統 MCP 服務器主要通過標準輸入輸出 (stdio) 進行傳輸，存在諸多缺點：

1. 使用不便：每個 MCP 客戶端都需要充當進程管理器。以 Claude Desktop 的配置方式為例，它需要維護一個要運行的進程列表。
2. 基礎設施問題多：若有多個用戶，且每個用戶可能有不同的 MCP 服務器配置（例如，他們可能使用不同的憑據來訪問底層 MCP 服務器，如 Github、Google Drive 等），那麼將面臨大量的進程管理和請求路由問題。
3. 啟動速度慢：默認情況下，啟動一個 MCP 服務器的方式是 npx ... 或 uvx ...，這會帶來這些工具固有的延遲（通常需要 2 - 3 秒的啟動時間）。

提供更優解決方案

本項目將 MCP 服務器轉變為網絡服務器，通過網絡進行通信而非 stdio，從而帶來以下優勢：

• 管理和擴展更輕鬆：通過 WebSocket 暴露 MCP 服務器，能更方便地進行管理和擴展。
• 交互方式更高效：提供了無需管理進程即可程序化地與 MCP 服務器交互的方式，提升了性能和用戶體驗。