Exemplo de Servidor MCP

MCP 服务示例

本项目为 Código Fonte TV 频道的教育用途而创建，演示了如何构建一个集成外部 API 并验证数据的 MCP 服务。

此代码仓库包含一个使用 Node.js/TypeScript 实现的 MCP（Model Context Protocol）服务示例，提供两个工具，用于通过美国国家气象局（NWS）的 API 获取天气信息。

功能

• get-alerts：返回某个州当前有效的天气警报（两个字母的代码，例如：CA、NY）。
• get-forecast：根据地理坐标（纬度、经度）返回天气预报。
• 使用 Zod 验证输入。
• 使用 fetch 集成 NWS API（基础设施层）。
• 使用 MCP 协议通过 stdio 通信（@modelcontextprotocol/sdk）。

架构

项目采用受领域驱动设计（DDD）模式启发的分层架构：

• Domain（src/domain）： 定义表示数据结构的接口和类型（例如：AlertFeature、ForecastPeriod、AlertsResponse）。

• Infrastructure（src/infrastructure）： 实现外部服务，例如负责向 NWS API 发起 HTTP 请求的 NWSApiService。

• Application（src/application）： 包含 WeatherService 中的业务逻辑，用于处理并格式化来自基础设施的数据。

• Interface（src/interface）： 包含控制器（WeatherToolsController），用于在 MCP 服务中注册工具、定义验证 schema 并返回结果。

• Entry Point（src/main.ts）： 初始化 McpServer，配置传输方式（StdioServerTransport），实例化服务和控制器，并启动 stdio 监听。

文件夹结构如下：

src/
├── domain/
│   └── models/           # Interfaces de domínio
├── infrastructure/
│   └── services/         # Implementações da API externa (NWS)
├── application/
│   └── services/         # Lógica de negócio e formatação de dados
├── interface/
│   └── controllers/      # Registro das ferramentas MCP e validação
└── main.ts               # Ponto de entrada do servidor
build/                     # Código JavaScript compilado

安装

git clone <REPOSITÓRIO_URL>
cd mcp-server-sample
npm install
npm run build

使用

构建完成后，你可以直接运行服务：

node build/main.js

或者，如果已注册为二进制文件（weather）：

npm link
weather

服务将在标准输出（stdio）上启动，并等待 MCP 请求。

贡献

欢迎提交拉取请求！欢迎随时创建 issue 并讨论改进建议。

Código Fonte TV

如需了解实现详情，请观看 Código Fonte TV 频道的视频。