JinDaGe - mcp-server-server MCP Details

article

README

🚀 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 客户端都需要成为一个进程管理器。Claude Desktop 的配置方式就是一个很好的例证——它需要维护一个要运行的进程列表。而本项目通过 WebSocket 暴露服务器，无需客户端进行复杂的进程管理。
解决基础设施问题：如果你有多个用户，他们每个人可能有不同的 MCP 服务器配置（例如，他们可能使用不同的凭据来访问底层 MCP 服务器，如 Github、Google Drive 等），传统方式会面临大量的进程管理和请求路由的问题。本项目提供了更高效的管理和扩展方式，解决了这一难题。
解决启动速度慢问题：默认情况下启动一个 MCP 服务器的方式是 npx ... 或 uvx ...，这带来了这些工具固有的延迟（通常需要 2 - 3 秒的启动时间）。本项目通过优化启动方式，提升了启动速度。

提供更优方案

如果 MCP 服务器实际上是网络服务器，即通过网络进行通信而不是 stdio，那么你可以更轻松地在程序中使用它们。本项目通过将 MCP 服务器转换为 WebSocket 服务器，实现了更高效的程序化交互方式，解决了现有 MCP 服务器管理复杂、启动缓慢的问题，同时提升了性能和用户体验。

mcp-server-server