@cyanheads/nws-weather-mcp-server 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/CLAUDE.md +309 -0
  2. package/Dockerfile +99 -0
  3. package/LICENSE +190 -0
  4. package/README.md +249 -0
  5. package/dist/config/server-config.d.ts +12 -0
  6. package/dist/config/server-config.d.ts.map +1 -0
  7. package/dist/config/server-config.js +19 -0
  8. package/dist/config/server-config.js.map +1 -0
  9. package/dist/index.d.ts +7 -0
  10. package/dist/index.d.ts.map +1 -0
  11. package/dist/index.js +23 -0
  12. package/dist/index.js.map +1 -0
  13. package/dist/mcp-server/resources/definitions/alert-types.resource.d.ts +7 -0
  14. package/dist/mcp-server/resources/definitions/alert-types.resource.d.ts.map +1 -0
  15. package/dist/mcp-server/resources/definitions/alert-types.resource.js +27 -0
  16. package/dist/mcp-server/resources/definitions/alert-types.resource.js.map +1 -0
  17. package/dist/mcp-server/resources/definitions/index.d.ts +6 -0
  18. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  19. package/dist/mcp-server/resources/definitions/index.js +6 -0
  20. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  21. package/dist/mcp-server/tools/definitions/find-stations.tool.d.ts +22 -0
  22. package/dist/mcp-server/tools/definitions/find-stations.tool.d.ts.map +1 -0
  23. package/dist/mcp-server/tools/definitions/find-stations.tool.js +60 -0
  24. package/dist/mcp-server/tools/definitions/find-stations.tool.js.map +1 -0
  25. package/dist/mcp-server/tools/definitions/get-forecast.tool.d.ts +33 -0
  26. package/dist/mcp-server/tools/definitions/get-forecast.tool.d.ts.map +1 -0
  27. package/dist/mcp-server/tools/definitions/get-forecast.tool.js +125 -0
  28. package/dist/mcp-server/tools/definitions/get-forecast.tool.js.map +1 -0
  29. package/dist/mcp-server/tools/definitions/get-observations.tool.d.ts +30 -0
  30. package/dist/mcp-server/tools/definitions/get-observations.tool.d.ts.map +1 -0
  31. package/dist/mcp-server/tools/definitions/get-observations.tool.js +177 -0
  32. package/dist/mcp-server/tools/definitions/get-observations.tool.js.map +1 -0
  33. package/dist/mcp-server/tools/definitions/index.d.ts +10 -0
  34. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  35. package/dist/mcp-server/tools/definitions/index.js +10 -0
  36. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  37. package/dist/mcp-server/tools/definitions/list-alert-types.tool.d.ts +10 -0
  38. package/dist/mcp-server/tools/definitions/list-alert-types.tool.d.ts.map +1 -0
  39. package/dist/mcp-server/tools/definitions/list-alert-types.tool.js +28 -0
  40. package/dist/mcp-server/tools/definitions/list-alert-types.tool.js.map +1 -0
  41. package/dist/mcp-server/tools/definitions/search-alerts.tool.d.ts +51 -0
  42. package/dist/mcp-server/tools/definitions/search-alerts.tool.d.ts.map +1 -0
  43. package/dist/mcp-server/tools/definitions/search-alerts.tool.js +242 -0
  44. package/dist/mcp-server/tools/definitions/search-alerts.tool.js.map +1 -0
  45. package/dist/mcp-server/tools/format-utils.d.ts +11 -0
  46. package/dist/mcp-server/tools/format-utils.d.ts.map +1 -0
  47. package/dist/mcp-server/tools/format-utils.js +27 -0
  48. package/dist/mcp-server/tools/format-utils.js.map +1 -0
  49. package/dist/services/nws/nws-service.d.ts +62 -0
  50. package/dist/services/nws/nws-service.d.ts.map +1 -0
  51. package/dist/services/nws/nws-service.js +372 -0
  52. package/dist/services/nws/nws-service.js.map +1 -0
  53. package/dist/services/nws/types.d.ts +96 -0
  54. package/dist/services/nws/types.d.ts.map +1 -0
  55. package/dist/services/nws/types.js +6 -0
  56. package/dist/services/nws/types.js.map +1 -0
  57. package/package.json +82 -0
  58. package/server.json +101 -0
package/package.json ADDED
@@ -0,0 +1,82 @@
1
+ {
2
+ "name": "@cyanheads/nws-weather-mcp-server",
3
+ "version": "0.3.1",
4
+ "description": "Real-time US weather data via the National Weather Service API. Forecasts, alerts, and observations with zero auth.",
5
+ "type": "module",
6
+ "main": "dist/index.js",
7
+ "types": "dist/index.d.ts",
8
+ "bin": {
9
+ "nws-weather-mcp-server": "dist/index.js"
10
+ },
11
+ "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
12
+ "scripts": {
13
+ "build": "bun scripts/build.ts",
14
+ "rebuild": "bun scripts/clean.ts && bun scripts/build.ts",
15
+ "clean": "bun scripts/clean.ts",
16
+ "devcheck": "bun scripts/devcheck.ts",
17
+ "tree": "bun scripts/tree.ts",
18
+ "format": "biome check --write --unsafe .",
19
+ "lint:mcp": "bun scripts/lint-mcp.ts",
20
+ "test": "vitest run",
21
+ "dev:stdio": "MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
22
+ "dev:http": "MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
23
+ "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
24
+ "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
25
+ },
26
+ "mcpName": "io.github.cyanheads/nws-weather-mcp-server",
27
+ "keywords": [
28
+ "mcp",
29
+ "mcp-server",
30
+ "model-context-protocol",
31
+ "weather",
32
+ "nws",
33
+ "national-weather-service",
34
+ "forecast",
35
+ "alerts",
36
+ "observations",
37
+ "typescript"
38
+ ],
39
+ "repository": {
40
+ "type": "git",
41
+ "url": "git+https://github.com/cyanheads/nws-weather-mcp-server.git"
42
+ },
43
+ "homepage": "https://github.com/cyanheads/nws-weather-mcp-server#readme",
44
+ "bugs": {
45
+ "url": "https://github.com/cyanheads/nws-weather-mcp-server/issues"
46
+ },
47
+ "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/nws-weather-mcp-server#readme)",
48
+ "funding": [
49
+ {
50
+ "type": "github",
51
+ "url": "https://github.com/sponsors/cyanheads"
52
+ },
53
+ {
54
+ "type": "buy_me_a_coffee",
55
+ "url": "https://www.buymeacoffee.com/cyanheads"
56
+ }
57
+ ],
58
+ "license": "Apache-2.0",
59
+ "engines": {
60
+ "node": ">=22.0.0",
61
+ "bun": ">=1.2.0"
62
+ },
63
+ "packageManager": "bun@1.3.11",
64
+ "publishConfig": {
65
+ "access": "public"
66
+ },
67
+ "dependencies": {
68
+ "@cyanheads/mcp-ts-core": "^0.2.12",
69
+ "@opentelemetry/api": "^1.9.1",
70
+ "pino-pretty": "^13.1.3"
71
+ },
72
+ "devDependencies": {
73
+ "@biomejs/biome": "^2.4.7",
74
+ "@types/node": "^25.5.0",
75
+ "@vitest/coverage-istanbul": "^4.1.2",
76
+ "depcheck": "^1.4.7",
77
+ "ignore": "^7.0.5",
78
+ "tsc-alias": "^1.8.16",
79
+ "typescript": "^5.9.3",
80
+ "vitest": "^4.1.0"
81
+ }
82
+ }
package/server.json ADDED
@@ -0,0 +1,101 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/nws-weather-mcp-server",
4
+ "description": "Real-time US weather data via the National Weather Service API. Forecasts, alerts, and observations with zero auth.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/nws-weather-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "version": "0.3.1",
10
+ "packages": [
11
+ {
12
+ "registryType": "npm",
13
+ "registryBaseUrl": "https://registry.npmjs.org",
14
+ "identifier": "@cyanheads/nws-weather-mcp-server",
15
+ "runtimeHint": "bun",
16
+ "version": "0.3.1",
17
+ "packageArguments": [
18
+ { "type": "positional", "value": "run" },
19
+ { "type": "positional", "value": "start:stdio" }
20
+ ],
21
+ "environmentVariables": [
22
+ {
23
+ "name": "NWS_USER_AGENT",
24
+ "description": "User-Agent header for NWS API requests. The API requires this header but a default is provided.",
25
+ "format": "string",
26
+ "isRequired": false,
27
+ "default": "(nws-weather-mcp-server, github.com/cyanheads/nws-weather-mcp-server)"
28
+ },
29
+ {
30
+ "name": "MCP_LOG_LEVEL",
31
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
32
+ "format": "string",
33
+ "isRequired": false,
34
+ "default": "info"
35
+ }
36
+ ],
37
+ "transport": {
38
+ "type": "stdio"
39
+ }
40
+ },
41
+ {
42
+ "registryType": "npm",
43
+ "registryBaseUrl": "https://registry.npmjs.org",
44
+ "identifier": "@cyanheads/nws-weather-mcp-server",
45
+ "runtimeHint": "bun",
46
+ "version": "0.3.1",
47
+ "packageArguments": [
48
+ { "type": "positional", "value": "run" },
49
+ { "type": "positional", "value": "start:http" }
50
+ ],
51
+ "environmentVariables": [
52
+ {
53
+ "name": "NWS_USER_AGENT",
54
+ "description": "User-Agent header for NWS API requests. The API requires this header but a default is provided.",
55
+ "format": "string",
56
+ "isRequired": false,
57
+ "default": "(nws-weather-mcp-server, github.com/cyanheads/nws-weather-mcp-server)"
58
+ },
59
+ {
60
+ "name": "MCP_HTTP_HOST",
61
+ "description": "The hostname for the HTTP server.",
62
+ "format": "string",
63
+ "isRequired": false,
64
+ "default": "127.0.0.1"
65
+ },
66
+ {
67
+ "name": "MCP_HTTP_PORT",
68
+ "description": "The port to run the HTTP server on.",
69
+ "format": "string",
70
+ "isRequired": false,
71
+ "default": "3010"
72
+ },
73
+ {
74
+ "name": "MCP_HTTP_ENDPOINT_PATH",
75
+ "description": "The endpoint path for the MCP server.",
76
+ "format": "string",
77
+ "isRequired": false,
78
+ "default": "/mcp"
79
+ },
80
+ {
81
+ "name": "MCP_AUTH_MODE",
82
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
83
+ "format": "string",
84
+ "isRequired": false,
85
+ "default": "none"
86
+ },
87
+ {
88
+ "name": "MCP_LOG_LEVEL",
89
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
90
+ "format": "string",
91
+ "isRequired": false,
92
+ "default": "info"
93
+ }
94
+ ],
95
+ "transport": {
96
+ "type": "streamable-http",
97
+ "url": "http://localhost:3010/mcp"
98
+ }
99
+ }
100
+ ]
101
+ }