Exemplo de Servidor MCP
2025.04.22
14
TypeScript天气服务教育示例位置服务
mcp-server-sample 是一个基于 Node.js/TypeScript 的 MCP（Model Context Protocol）服务器示例项目，主要用于教育目的。该项目展示了如何构建一个与外部 API（如美国国家气象局 NWS）集成的 MCP 服务器，并提供数据验证功能。核心功能包括获取天气警报和天气预报，适用于需要实时天气信息的应用场景。
View on GitHub
Overview
基本能力
产品定位
mcp-server-sample 是一个教育性质的 MCP 服务器示例，用于演示如何构建与外部 API 集成的 MCP 服务器。
核心功能
- get-alerts: 返回指定州的活跃天气警报（使用两字母州代码，如
CA,NY）。 - get-forecast: 返回指定地理坐标（纬度、经度）的天气预报。
- 使用 Zod 进行输入验证。
- 通过
fetch与 NWS API 集成。 - 使用 MCP 协议（
@modelcontextprotocol/sdk）通过 stdio 进行通信。
适用场景
- 需要实时天气信息的应用。
- 教育或演示 MCP 服务器构建的场景。
工具列表
- get-alerts: 获取指定州的天气警报。
- get-forecast: 获取指定地理坐标的天气预报。
常见问题解答
- 无明确常见问题解答部分。
使用教程
使用依赖
- Node.js
- npm
安装教程
git clone <REPOSITÓRIO_URL>
cd mcp-server-sample
npm install
npm run build
调试方式
node build/main.js
或
npm link
weather