open-meteo-mcp-weather-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MCP_SO_SUBMISSION.md

@@ -0,0 +1,63 @@
+# mcp.so Submission
+
+Submit page:
+
+https://mcp.so/zh/submit
+
+Recommended fields:
+
+- Type: MCP Server
+- Name: my-weather-server-0706
+- URL: https://github.com/yangvue/my-weather-server-0706
+- Description: MCP server for querying current weather by city using Open-Meteo. It provides a `get_weather` tool and does not require an API key.
+
+Server Config:
+
+```json
+{
+  "mcpServers": {
+    "my-weather-server-0706": {
+      "command": "npx",
+      "args": ["-y", "open-meteo-mcp-weather-server"]
+    }
+  }
+}
+```
+
+Server Config for GitHub/local source:
+
+```json
+{
+  "mcpServers": {
+    "my-weather-server-0706": {
+      "command": "npx",
+      "args": ["-y", "github:yangvue/my-weather-server-0706"]
+    }
+  }
+}
+```
+
+Server Config for local checkout:
+
+```json
+{
+  "mcpServers": {
+    "my-weather-server-0706": {
+      "command": "node",
+      "args": ["/absolute/path/to/my-mcp-server/index.js"]
+    }
+  }
+}
+```
+
+Tools:
+
+- `get_weather`: Get current real weather for a city.
+
+Example input:
+
+```json
+{
+  "city": "上海"
+}
+```

package/README.md

@@ -0,0 +1,105 @@
+# my-weather-server-0706
+
+MCP server for querying current weather by city. It uses Open-Meteo geocoding and forecast APIs, and exposes one MCP tool: `get_weather`.
+
+## Tools
+
+### `get_weather`
+
+Get current weather for a city.
+
+Input:
+
+```json
+{
+  "city": "上海"
+}
+```
+
+Output:
+
+```text
+通过 my-weather-server-0706 返回：上海 当前天气是：阴天
+定位：上海，上海市，中国
+温度：...
+体感温度：...
+湿度：...
+降水：...
+云量：...
+风速：...
+风向：...
+更新时间：...
+```
+
+## Install
+
+From GitHub:
+
+```bash
+npx -y github:yangvue/my-weather-server-0706
+```
+
+From npm, once published:
+
+```bash
+npx -y open-meteo-mcp-weather-server
+```
+
+From this repository:
+
+```bash
+npm install
+npm start
+```
+
+## MCP Configuration
+
+Use this config to run from GitHub:
+
+```json
+{
+  "mcpServers": {
+    "my-weather-server-0706": {
+      "command": "npx",
+      "args": ["-y", "github:yangvue/my-weather-server-0706"]
+    }
+  }
+}
+```
+
+Use this config after the package is published to npm:
+
+```json
+{
+  "mcpServers": {
+    "my-weather-server-0706": {
+      "command": "npx",
+      "args": ["-y", "open-meteo-mcp-weather-server"]
+    }
+  }
+}
+```
+
+Use this config when running from a local checkout:
+
+```json
+{
+  "mcpServers": {
+    "my-weather-server-0706": {
+      "command": "node",
+      "args": ["/absolute/path/to/my-mcp-server/index.js"]
+    }
+  }
+}
+```
+
+## Data Source
+
+- Geocoding: Open-Meteo Geocoding API
+- Weather: Open-Meteo Forecast API
+
+No API key is required.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { appendFileSync } from "node:fs";
+
+const GEOCODING_API_URL = "https://geocoding-api.open-meteo.com/v1/search";
+const WEATHER_API_URL = "https://api.open-meteo.com/v1/forecast";
+const LOG_FILE_URL = new URL("./weather-server.log", import.meta.url);
+
+const server = new Server({
+  name: "my-weather-server-0706",
+  version: "1.0.0"
+}, {
+  capabilities: { tools: {} }
+});
+
+const weatherCodeMap = new Map([
+  [0, "晴朗"],
+  [1, "大部晴朗"],
+  [2, "局部多云"],
+  [3, "阴天"],
+  [45, "有雾"],
+  [48, "有霜雾"],
+  [51, "小毛毛雨"],
+  [53, "中等毛毛雨"],
+  [55, "大毛毛雨"],
+  [56, "小冻毛毛雨"],
+  [57, "大冻毛毛雨"],
+  [61, "小雨"],
+  [63, "中雨"],
+  [65, "大雨"],
+  [66, "小冻雨"],
+  [67, "大冻雨"],
+  [71, "小雪"],
+  [73, "中雪"],
+  [75, "大雪"],
+  [77, "雪粒"],
+  [80, "小阵雨"],
+  [81, "中等阵雨"],
+  [82, "强阵雨"],
+  [85, "小阵雪"],
+  [86, "强阵雪"],
+  [95, "雷暴"],
+  [96, "雷暴伴小冰雹"],
+  [99, "雷暴伴大冰雹"],
+]);
+
+function logServer(message) {
+  const line = `[my-weather-server-0706] ${new Date().toISOString()} ${message}`;
+  console.error(line);
+  appendFileSync(LOG_FILE_URL, `${line}\n`, "utf8");
+}
+
+logServer(`startup pid=${process.pid} cwd=${process.cwd()} entry=${import.meta.url}`);
+
+async function fetchJson(url, apiName) {
+  const response = await fetch(url, {
+    headers: {
+      "User-Agent": "my-weather-server-0706/1.0",
+    },
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`${apiName} 请求失败：HTTP ${response.status} ${errorText}`);
+  }
+
+  const data = await response.json();
+  if (data.error) {
+    throw new Error(`${apiName} 请求失败：${data.reason ?? "未知错误"}`);
+  }
+
+  return data;
+}
+
+async function findLocation(city) {
+  const url = new URL(GEOCODING_API_URL);
+  url.searchParams.set("name", city);
+  url.searchParams.set("count", "1");
+  url.searchParams.set("language", "zh");
+  url.searchParams.set("format", "json");
+
+  const data = await fetchJson(url, "地理编码 API");
+  const location = data.results?.[0];
+  if (!location) {
+    throw new Error(`没有找到城市：${city}`);
+  }
+
+  return location;
+}
+
+async function fetchCurrentWeather(location) {
+  const url = new URL(WEATHER_API_URL);
+  url.searchParams.set("latitude", String(location.latitude));
+  url.searchParams.set("longitude", String(location.longitude));
+  url.searchParams.set(
+    "current",
+    [
+      "temperature_2m",
+      "relative_humidity_2m",
+      "apparent_temperature",
+      "precipitation",
+      "weather_code",
+      "cloud_cover",
+      "wind_speed_10m",
+      "wind_direction_10m",
+    ].join(",")
+  );
+  url.searchParams.set("timezone", "auto");
+
+  const data = await fetchJson(url, "天气 API");
+  if (!data.current) {
+    throw new Error("天气 API 没有返回当前天气数据");
+  }
+
+  return data;
+}
+
+function formatWindDirection(degrees) {
+  if (typeof degrees !== "number") {
+    return "未知";
+  }
+
+  const directions = ["北", "东北", "东", "东南", "南", "西南", "西", "西北"];
+  return directions[Math.round(degrees / 45) % directions.length];
+}
+
+function formatWeather(city, location, weatherData) {
+  const current = weatherData.current;
+  const units = weatherData.current_units ?? {};
+  const weatherText = weatherCodeMap.get(current.weather_code) ?? `天气代码 ${current.weather_code}`;
+  const locationName = [location.name, location.admin1, location.country]
+    .filter(Boolean)
+    .join("，");
+
+  return [
+    `通过 my-weather-server-0706 返回：${city} 当前天气是：${weatherText}`,
+    `定位：${locationName}`,
+    `温度：${current.temperature_2m}${units.temperature_2m ?? "°C"}`,
+    `体感温度：${current.apparent_temperature}${units.apparent_temperature ?? "°C"}`,
+    `湿度：${current.relative_humidity_2m}${units.relative_humidity_2m ?? "%"}`,
+    `降水：${current.precipitation}${units.precipitation ?? "mm"}`,
+    `云量：${current.cloud_cover}${units.cloud_cover ?? "%"}`,
+    `风速：${current.wind_speed_10m}${units.wind_speed_10m ?? "km/h"}`,
+    `风向：${formatWindDirection(current.wind_direction_10m)}（${current.wind_direction_10m}${units.wind_direction_10m ?? "°"}）`,
+    `更新时间：${current.time}`,
+  ].join("\n");
+}
+
+// 定义工具
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [{
+    name: "get_weather",
+    description: "通过 my-weather-server-0706 获取指定城市的当前真实天气",
+    inputSchema: {
+      type: "object",
+      properties: {
+        city: { type: "string", description: "城市名称" }
+      },
+      required: ["city"]
+    }
+  }]
+}));
+
+// 执行逻辑
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name !== "get_weather") {
+    throw new Error(`未知工具：${request.params.name}`);
+  }
+
+  const city = request.params.arguments?.city;
+  if (typeof city !== "string" || city.trim() === "") {
+    throw new Error("city 参数必须是非空字符串");
+  }
+
+  const normalizedCity = city.trim();
+  logServer(`callTool name=get_weather city=${normalizedCity}`);
+
+  const location = await findLocation(normalizedCity);
+  const weatherData = await fetchCurrentWeather(location);
+  logServer(
+    `get_weather success location=${location.name},${location.admin1 ?? ""},${location.country ?? ""} weather_code=${weatherData.current.weather_code}`
+  );
+
+  return {
+    content: [{ type: "text", text: formatWeather(normalizedCity, location, weatherData) }]
+  };
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "open-meteo-mcp-weather-server",
+  "version": "1.0.0",
+  "description": "MCP server that provides current weather by city using Open-Meteo.",
+  "main": "index.js",
+  "bin": {
+    "my-weather-server-0706": "index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yangvue/my-weather-server-0706.git"
+  },
+  "homepage": "https://github.com/yangvue/my-weather-server-0706#readme",
+  "bugs": {
+    "url": "https://github.com/yangvue/my-weather-server-0706/issues"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "inspect:tools": "npx @modelcontextprotocol/inspector node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "weather",
+    "open-meteo",
+    "china"
+  ],
+  "author": "",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+}