Weather Server MCP Server H72

🚀 天气服务器 MCP 服务器

本项目是一个测试天气服务器的工具，基于 TypeScript 构建的 MCP 服务器，实现了一套天气信息系统。它通过带有 URI 和元数据的天气数据资源、获取与更新天气信息的工具以及生成天气摘要提示等方式，生动演示了核心 MCP 概念。

🚀 快速开始

本项目是一个基于 TypeScript 的 MCP 服务器，实现了天气信息系统，可通过特定工具获取、更新天气信息并生成摘要。

✨ 主要特性

资源

• 可列出并通过 weather:// URI 访问天气数据。
• 每个天气条目包含位置、温度和元数据。
• 采用 JSON MIME 类型进行结构化数据访问。

工具

• fetch_weather：用于获取当前天气信息。
  • 必须传入位置作为参数。
  • 从外部 API 获取天气数据。
• update_weather：用于更新天气信息。
  • 必须传入位置和新天气数据作为参数。
  • 更新服务器状态中的天气数据。

提示

• summarize_weather：生成当前天气数据的摘要。
  • 包含所有天气条目作为嵌入资源。
  • 返回结构化提示供 LLM 进行摘要处理。

📦 安装指南

开发环境依赖安装

npm install

环境文件配置

将 .envexample 重命名为 .env：

mv .envexample .env

在 .env 文件中更新 OPENWEATHER_API_KEY：

OPENWEATHER_API_KEY=您的自有 OpenWeather API 密钥

服务器构建

npm run build

开发模式（自动重建）

npm run watch

与 Claude Desktop 集成

要与 Claude Desktop 配合使用，需添加服务器配置：

• 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
• 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weatherserver": {
      "command": "/path/to/weatherserver/build/index.js"
    }
  }
}

调试建议

由于 MCP 服务器通过 stdio 进行通信，调试可能具有一定挑战性。我们推荐使用 MCP Inspector，它可作为包脚本使用：

npm run inspector

Inspector 将提供一个可访问浏览器调试工具的 URL。