AI导哈

天气数据服务

提供美国天气警报和预报的TypeScript服务器实现，通过MCP协议集成国家气象局API。

  • by bin-r00t
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 bin-r00t/personal-mcps

使用说明

CLAUDE.md

此文件为使用此存储库中的代码时的Claude Code（Claude.ai/Code）提供了指导。

项目概述

这是一个包含用TypeScript编写的模型上下文协议（MCP）服务器的存储库。存储库包含两个MCP服务器实现：

  1. 天气mcp -提供美国天气数据访问的天气信息服务器
  2. bfl mcp -黑森林实验室集成服务器（当前为空/占位符）

这两台服务器都是使用 @modelcontextprotocol/sdk 并通过MCP协议提供工具。

建筑

气象mcp服务器

  • 位置: weather-mcp/
  • 目的：为美国各地提供天气警报和预报
  • API集成：使用美国国家气象局（NWS）API
  • 工具:
    • get_alerts：获取美国某州的天气警报
    • get_forecast：获取坐标的天气预报

bfl-mcp服务器

  • 位置: bfl-mcp/
  • 目的：黑森林实验室集成占位符
  • 状态：空的实施准备发展

开发命令

建筑

# Build weather-mcp
cd weather-mcp && npm run build

# Build bfl-mcp
cd bfl-mcp && npm run build

安装

# Install dependencies for weather-mcp
cd weather-mcp && npm install

# Install dependencies for bfl-mcp
cd bfl-mcp && npm install

编码结构

气象mcp结构

weather-mcp/
├── src/
│   ├── index.ts              # Main server entry point
│   ├── vars.ts               # Constants (API base URLs, user agent)
│   ├── helpers.ts            # Utility functions and types
│   └── tools/
│       ├── get_alerts.ts     # Weather alerts tool implementation
│       └── get_forecast.ts   # Weather forecast tool implementation
├── build/                    # Compiled JavaScript output
├── package.json
└── tsconfig.json

关键组件

MCP服务器设置

  • 用途 McpServer 从 @modelcontextprotocol/sdk/server/mcp.js
  • 通过以下方式进行沟通 StdioServerTransport
  • 工具注册使用 server.tool() 方法

TypeScript配置

  • 目标：ES2022
  • 模块：Node16
  • 输出目录： ./build
  • 严格模式已启用

错误处理

  • 所有API请求都包装在try-chatch块中
  • 向MCP客户端返回优美的错误响应
  • 用于调试的控制台错误日志记录

开发说明

天气API集成

  • weather-mcp服务器与美国国家气象局API集成
  • 仅支持美国位置（纬度/经度坐标）
  • API请求需要正确的User-Agent头
  • 实施API速率限制和错误处理

工具实现模式

  • 工具在中作为单独的模块实现 src/tools/
  • 每个工具导出一个 ToolCallback 函数
  • 用于参数验证的Zod模式
  • 与内容数组一致的响应格式

构建过程

  • TypeScript编译到 build/ 目录
  • 在生成输出上设置可执行权限
  • ES模块配置("type": "module")

测试

要在构建后测试MCP服务器，请执行以下操作：

# Run weather server
./weather-mcp/build/index.js

# Test with MCP client (Claude Desktop, etc.)
# Add server configuration pointing to build/index.js

相关 MCP