mcp-server-server

这个仓库是一个MCP服务器的概念验证项目，允许你启动其他MCP服务器。

但...为什么？

使用MCP服务器很不方便。

MCP服务器的主要传输机制是标准输入输出(stdio)，即在你的MCP客户端程序中，你需要为想要使用的每个MCP服务器 spawn一个新进程。 这有缺点：

1. 它很麻烦——每个MCP客户端都需要成为一个进程管理器。Claude Desktop的配置方式就是一个很好的例证——它需要维护一个要运行的进程列表。
2. 它带来了一个基础设施问题：如果你有多个用户，他们每个人都需要不同的MCP服务器配置（例如，他们都具有访问不同底层MCP服务器的身份验证凭据，如Github、Google Drive等），那么你将面临大量需要管理和路由客户端请求的进程。

更好的方法

如果MCP服务器实际上是...服务器？即通过网络而不是stdio进行通信？ 那么你可以更轻松地使用它们进行程序化操作。

第1步：将现有的stdio MCP服务器转换为WebSocket MCP服务器

这个仓库包含一个包装程序，它会将现有MCP服务器（这里 是官方的一个列表，但现在它们已经分散）通过websocket暴露出来：

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

第2步：无需管理进程即可程序化地与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.map((t) => t.name)
);
await client.close();

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

第3步：构建MCP服务器

TODO: 我们尚未解决第二个问题，即作为MCP客户端开发人员，在第1步中仍需为特定的MCP服务器和用户配置 spawn一个程序。如果有一个单一的MCP服务器可以公开工具来启动...

完整翻译如下：

项目目标

此仓库旨在展示如何将传统的基于stdio的MCP服务器转换为通过WebSocket进行通信的网络服务器，从而简化客户端与其交互的方式。

核心优势

1. 消除进程管理：不再需要在客户端中 spawn多个进程来管理不同的MCP服务器。
2. 提升可扩展性：通过网络通信，使得多个用户和不同的配置可以更高效地管理和路由请求。

实现步骤

1. 将现有MCP服务器封装为WebSocket服务

使用提供的包装程序，你可以轻松将任何现有的MCP服务器（如Puppeteer）转换为基于WebSocket的服务。例如：

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

这行命令会在端口3001上启动一个WebSocket服务，封装了Puppeteer MCP服务器。

2. 使用SDK进行程序化交互

通过MCP SDK和WebSocket客户端传输模块，你可以轻松地与新的WebSocket 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.map((t) => t.name)
);
await client.close();

运行此代码：

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

输出将显示可用的工具列表。

3. 扩展至MCP服务器即服务

TODO: 目前，我们尚未解决第二个问题，即作为MCP客户端开发人员，在第1步中仍需为特定的MCP服务器和用户配置 spawn一个程序。如果有一个单一的MCP服务器可以公开工具来启动...

通过这些步骤，我们可以看到将传统的stdio-based MCP服务器转换为网络服务的巨大潜力。这不仅简化了客户端的使用方式，还为构建更复杂的MCP生态系统铺平了道路。

未来方向

1. 统一接口：开发一个通用的MCP服务器接口，使得任何服务器都可以轻松地通过WebSocket或其他协议暴露。
2. 自动化配置：实现自动化的用户配置管理，减少手动 spawn进程的需求。
3. 多租户支持：构建支持多用户的架构，允许每个用户根据其需求定制和启动不同的MCP服务器实例。

结论

将MCP服务器转换为网络服务是一个革命性的改进，能够极大地提升开发效率和系统扩展性。尽管目前仍有一些问题需要解决，但这一方向无疑值得深入探索和实践。