🚀 天气MCP服务器

这是一个使用TypeScript开发的天气MCP（模型上下文协议）服务器，可提供模拟天气数据及相关功能。

✨ 主要特性

• 🌤️ 获取当前天气信息
• 📅 多日天气预报
• ⚠️ 天气预警系统
• 🔍 位置搜索功能
• 📊 天气统计
• 🎭 支持模拟数据

📦 安装指南

pnpm install

💻 使用示例

安装与构建

# 安装依赖
pnpm install

# 构建项目
pnpm run build

启动方式

1. MCP协议（stdio）

# 用于MCP客户端集成
pnpm start

2. HTTP API服务器 🆕

# 启动HTTP服务器（默认端口8080）
pnpm run start:http

# 启动HTTP服务器（指定端口3001）
pnpm run start:http:3001

# 或者直接指定端口
node dist/http-server.js 8080

3. 简易HTTP服务器（推荐） 🚀

# 使用默认端口8080启动
pnpm run start:simple

# 使用特定端口启动
pnpm run start:simple:3000  # 开发端口
pnpm run start:simple:5000  # 备用端口
pnpm run start:simple:9000  # 高端口

# 或者使用serve命令
pnpm run serve              # 默认端口8080
pnpm run serve:dev          # 开发端口3000
pnpm run serve:prod         # 生产端口8080

# 或者直接指定任意端口
node dist/simple-http-server.js 4000

动态端口支持

简易HTTP服务器支持动态端口配置：

# 使用任意你想要的端口
node dist/simple-http-server.js 3000
node dist/simple-http-server.js 5000
node dist/simple-http-server.js 9000
node dist/simple-http-server.js 12345

服务器将自动执行以下操作：

• 若未指定端口，默认使用8080端口
• 接受任何有效的端口号作为命令行参数
• 在启动消息和文档中显示实际使用的端口

HTTP API使用示例

一旦HTTP服务器启动，你可以通过以下方式使用它：

浏览器访问

• 打开 http://localhost:8080 查看API文档
• 直接点击链接测试各种API

curl命令

# 获取香港的当前天气
curl "http://localhost:8080/weather?location=Hong Kong"

# 获取东京的5天天气预报
curl "http://localhost:8080/forecast?location=Tokyo&days=5"

# 获取天气预警
curl "http://localhost:8080/alerts?location=Hong Kong"

# 搜索位置
curl "http://localhost:8080/locations?q=kong"

# 获取统计信息
curl "http://localhost:8080/stats"

JavaScript/Fetch

// 获取天气数据
const response = await fetch('http://localhost:8080/weather?location=Tokyo');
const weather = await response.json();
console.log(weather);

开发模式

# 监听模式编译
pnpm run dev

可用工具

1. get_current_weather

获取指定位置的当前天气信息

参数：

• location（字符串）：位置名称

示例：

{
  "location": "Hong Kong"
}

2. get_weather_forecast

获取指定位置的天气预报

参数：

• location（字符串）：位置名称
• days（数字，可选）：预报天数（1 - 7天，默认3天）

示例：

{
  "location": "Tokyo",
  "days": 5
}

3. get_weather_alerts

获取天气预警信息

参数：

• location（字符串，可选）：位置名称

示例：

{
  "location": "Hong Kong"
}

4. search_locations

搜索支持的位置

参数：

• query（字符串）：搜索关键词

示例：

{
  "query": "kong"
}

5. get_weather_stats

获取天气统计信息

参数： 无

支持的位置

目前支持以下位置的详细天气数据：

• 香港
• 东京、大阪、京都、广岛、札幌、福冈（日本）
• 伦敦（英国）
• 纽约（美国）
• 悉尼（澳大利亚）

其他位置将返回随机生成的模拟数据。

🔧 技术细节

技术规格

项目结构

src/
├── index.ts              # MCP服务器主文件（stdio）
├── http-server.ts        # HTTP API服务器
├── simple-http-server.ts # 简易HTTP服务器
├── weather-service.ts    # 天气服务逻辑
├── mock-data.ts          # 模拟数据
└── types.ts              # TypeScript类型定义

HTTP API端点

📄 许可证

本项目采用MIT许可证。