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 服务器交互的方式，提升了性能和用户体验。