【MCP Node.js SDK 全栈进阶指南】初级篇（2）：MCP基础服务器开发
引言
在上一篇文章中，我们详细介绍了MCP开发环境的搭建。本文作为MCP TypeScript-SDK系列的第二篇，将深入探讨MCP基础服务器开发的核心内容，包括服务器创建与生命周期管理、McpServer与Server的区别与选择、各种配置选项的详解，以及基本启动与调试技巧。通过本文学习，你将能够构建稳定、高效的MCP服务器，为后续开发高级功能打下坚实基础。
一、服务器创建与生命周期管理
1. MCP服务器基本概念
MCP服务器是MCP应用的核心组件，负责处理客户端请求、管理资源和工具、协调模型交互等核心功能。在TypeScript-SDK中，服务器实例是应用程序的中央控制点，具有完整的生命周期管理机制。
2. 服务器创建方式
MCP TypeScript-SDK提供了两种创建服务器的方式：
2.1 基本创建方式
import { McpServer } from '@modelcontextprotocol/sdk';// 创建服务器实例
const server = new McpServer({name: 'my-mcp-server',description: '我的MCP服务器',version: '1.0.0',
});
2.2 使用构建器模式（推荐用于复杂配置）
import { McpServerBuilder } from '@modelcontextprotocol/sdk';// 使用构建器模式创建
const server = new McpServerBuilder().withName('my-mcp-server').withDescription('我的MCP服务器').withVersion('1.0.0').withHttp({ port: 8080 }).build();
3. 服务器生命周期管理
MCP服务器具有明确的生命周期阶段，理解和正确管理这些阶段对于开发稳定的应用至关重要：
3.1 初始化阶段
服务器创建后但尚未启动的阶段，适合进行资源注册、工具注册等准备工作：
// 初始化阶段配置
server.registerTool({name: 'greeting',description: '发送问候',parameters: z.object({name: z.string().describe('被问候者的名字'),}),execute: async ({ name }) => {return `你好，${name}！`;},
});
3.2 启动阶段
服务器开始接受连接的阶段，此时完成所有传输层初始化：
// 启动服务器
await server.start();
console.log('服务器已启动，正在监听请求...');
3.3 运行阶段
服务器正常运行，处理客户端请求的阶段。在这个阶段，您可以动态修改服务器的工具和资源：
// 动态注册新工具
server.registerTool({name: 'dynamicTool',description: '运行时添加的工具',parameters: z.object({}),execute: async () => {return '这是运行时添加的工具';},
});
3.4 关闭阶段
优雅地终止服务器，释放资源的阶段：
// 优雅关闭服务器
await server.shutdown();
console.log('服务器已安全关闭');
4. 生命周期事件监听
MCP服务器提供了丰富的事件机制，允许开发者在不同生命周期阶段执行自定义逻辑：
// 监听服务器启动事件
server.on('start', () => {console.log('服务器启动事件触发');// 执行启动后的初始化工作
});// 监听服务器关闭事件
server.on('shutdown', () => {console.log('服务器关闭事件触发');// 执行资源清理工作
});// 监听错误事件
server.on('error', (error) => {console.error('服务器发生错误:', error);// 错误处理逻辑
});
二、McpServer与Server的区别与选择
MCP TypeScript-SDK提供了两种服务器实现：McpServer和Server，了解它们的区别对于选择合适的服务器类型至关重要。
1. McpServer介绍
McpServer是符合MCP协议规范的完整实现，提供了全面的功能支持：
-
特点：
- 完全符合MCP协议规范
- 内置资源和工具管理
- 支持多种传输层选项
- 包含丰富的元数据和发现机制
-
适用场景：
- 开发标准MCP应用
- 需要完整MCP协议支持的场景
- 多客户端交互的复杂应用
import { McpServer } from '@modelcontextprotocol/sdk';const mcpServer = new McpServer({name: 'standard-mcp-server',description: '标准MCP服务器实现',version: '1.0.0',// MCP协议的完整配置选项
});
2. Server介绍
Server是一个更轻量级的实现，专注于核心功能，适合特定场景：
-
特点：
- 轻量级实现，占用资源少
- 更简单的API接口
- 更灵活的自定义选项
- 更少的协议约束
-
适用场景：
- 资源受限的环境
- 简单的工具服务
- 需要高度定制的应用
- 内部系统集成
import { Server } from '@modelcontextprotocol/sdk';const lightServer = new Server({name: 'light-server',// 简化的配置选项
});
3. 选择指南
在选择服务器类型时，可以参考以下指南：
| 考虑因素 | McpServer | Server |
|---|---|---|
| 协议兼容性 | 完全兼容MCP标准 | 部分兼容 |
| 资源占用 | 较高 | 较低 |
| 功能完整性 | 完整功能集 | 核心功能集 |
| 配置复杂度 | 较复杂 | 较简单 |
| 扩展灵活性 | 标准化扩展 | 高度灵活 |
| 适用范围 | 大中型应用 | 小型或特定场景 |
4. 转换与互操作
在某些情况下，你可能需要在两种服务器类型之间进行转换或互操作：
import { McpServer, Server, convertToMcpServer } from '@modelcontextprotocol/sdk';// 从轻量服务器升级到完整MCP服务器
const lightServer = new Server({ name: