Remote-MCP：一款远程模型上下文通信的解决方案
项目地址: https://gitcode.com/gh_mirrors/re/Remote-MCP 项目介绍
Remote-MCP 是一个为远程模型上下文协议（Model Context Protocol，MCP）通信提供的类型安全、双向且简单的解决方案。它允许对模型上下文进行远程访问和集中管理，为开发者提供了一个高效且易于维护的通信框架。
Remote-MCP 的设计理念是填补当前 MCP 官方支持中的空缺，尤其是在远程访问需求迫切的情况下。尽管官方 MCP 路线图计划在 2025 年第一季度加入对远程 MCP 的支持，但 Remote-MCP 的出现为那些急需远程访问的用户提供了一种即时的解决方案。
项目技术分析
Remote-MCP 的架构设计采用了现代的微服务思想，将客户端、网关、后端和资源分离开来，通过 MCP 协议进行通信。这种设计不仅提高了系统的可扩展性，也使得维护和调试变得更加便捷。
项目使用 TypeScript 进行开发，确保了代码的类型安全。它依赖于 tRPC 框架来实现客户端和服务器之间的通信，以及 Zod 库进行数据验证。以下是 Remote-MCP 的核心组件：
@remote-mcp/client: 客户端库，作为本地 MCP 服务器，连接到远程实现。@remote-mcp/server: 服务器库，用于创建远程可访问的 MCP 服务。
项目及技术应用场景
Remote-MCP 的设计适用于多种场景，包括但不限于：
- 分布式系统: 在分布式系统中，Remote-MCP 可以为不同节点上的模型上下文提供统一的访问接口。
- 云服务: 当模型运行在云服务上时，Remote-MCP 可以帮助用户在本地和云端之间建立通信桥梁。
- 边缘计算: 在边缘计算环境中，Remote-MCP 可以实现边缘设备与中心服务器之间的实时数据同步。
项目特点
- 类型安全: 使用 TypeScript 开发，保证了代码的稳定性和可维护性。
- 双向通信: 支持客户端和服务器之间的双向数据传输，使得交互更加灵活。
- 简单易用: 设计简洁，易于上手，无需复杂的配置即可快速部署。
- 可扩展性: 支持插件和中间件，方便开发者根据需要扩展功能。
以下是一个简单的使用示例：
客户端使用
{
"mcpServers": {
"remote-mcp": {
"command": "npx",
"args": ["-y", "@remote-mcp/client"],
"env": {
"REMOTE_MCP_URL": "http://localhost:9512",
"HTTP_HEADER_Authorization": "Bearer <token>"
}
}
}
}
服务器端使用
import { MCPRouter, LogLevel } from "@remote-mcp/server";
import { createHTTPServer } from '@trpc/server/adapters/standalone';
const mcpRouter = new MCPRouter({
logLevel: LogLevel.DEBUG,
name: "example-server",
version: "1.0.0",
});
mcpRouter.addTool(
"calculator",
{
description: "Perform basic calculations.",
schema: z.object({
operation: z.enum(["add", "subtract", "multiply", "divide"]),
a: z.string(),
b: z.string(),
}),
},
async (args) => {
// ... 实现计算逻辑
},
);
const appRouter = mcpRouter.createTRPCRouter();
void createHTTPServer({
router: appRouter,
createContext: () => ({}),
}).listen(Number(process.env.PORT || 9512));
Remote-MCP 通过其简洁的设计和强大的功能，为远程 MCP 通信提供了一个实用的解决方案，值得开发者和企业关注和使用。