mcp-server-server

此仓库是一个 MCP 服务器的证明概念实现，通过 WebSocket 暴露另一个基于标准输入输出 (stdio) 的 MCP 服务器。

但...为什么？

使用 MCP 服务器很困难。

MCP 服务器的主要传输机制是 stdio，即在你的 MCP 客户端程序中，你需要为每个要使用的 MCP 服务器启动一个新进程。这有一些缺点：

1. 不方便：每个 MCP 客户端都需要成为一个进程管理器。Claude Desktop 的配置方式就是一个很好的例证——它需要维护一个要运行的进程列表。
2. 基础设施问题：如果你有多个用户，他们每个人可能有不同的 MCP 服务器配置（例如，他们可能使用不同的凭据来访问底层 MCP 服务器，如 Github、Google Drive 等），那么你将面临大量的进程管理和请求路由的问题。
3. 速度慢：默认情况下启动一个 MCP 服务器的方式是 npx ... 或 uvx ...，这带来了这些工具固有的延迟（通常需要 2-3 秒的启动时间）。

更好的方法

如果MCP服务器实际上是...网络服务器呢？即通过网络进行通信而不是stdio。这样你可以更轻松地在程序中使用它们。

第一步：将现有的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服务器管理复杂、启动缓慢的问题，并提供了更高效的程序化交互方式。通过WebSocket暴露MCP服务器，可以更容易地进行管理和扩展，同时也提升了性能和用户体验。