@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.
- package/CLAUDE.md +309 -0
- package/Dockerfile +99 -0
- package/LICENSE +190 -0
- package/README.md +249 -0
- package/dist/config/server-config.d.ts +12 -0
- package/dist/config/server-config.d.ts.map +1 -0
- package/dist/config/server-config.js +19 -0
- package/dist/config/server-config.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +23 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-server/resources/definitions/alert-types.resource.d.ts +7 -0
- package/dist/mcp-server/resources/definitions/alert-types.resource.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/alert-types.resource.js +27 -0
- package/dist/mcp-server/resources/definitions/alert-types.resource.js.map +1 -0
- package/dist/mcp-server/resources/definitions/index.d.ts +6 -0
- package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/resources/definitions/index.js +6 -0
- package/dist/mcp-server/resources/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/find-stations.tool.d.ts +22 -0
- package/dist/mcp-server/tools/definitions/find-stations.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/find-stations.tool.js +60 -0
- package/dist/mcp-server/tools/definitions/find-stations.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-forecast.tool.d.ts +33 -0
- package/dist/mcp-server/tools/definitions/get-forecast.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-forecast.tool.js +125 -0
- package/dist/mcp-server/tools/definitions/get-forecast.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/get-observations.tool.d.ts +30 -0
- package/dist/mcp-server/tools/definitions/get-observations.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/get-observations.tool.js +177 -0
- package/dist/mcp-server/tools/definitions/get-observations.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/index.d.ts +10 -0
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/index.js +10 -0
- package/dist/mcp-server/tools/definitions/index.js.map +1 -0
- package/dist/mcp-server/tools/definitions/list-alert-types.tool.d.ts +10 -0
- package/dist/mcp-server/tools/definitions/list-alert-types.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/list-alert-types.tool.js +28 -0
- package/dist/mcp-server/tools/definitions/list-alert-types.tool.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-alerts.tool.d.ts +51 -0
- package/dist/mcp-server/tools/definitions/search-alerts.tool.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/search-alerts.tool.js +242 -0
- package/dist/mcp-server/tools/definitions/search-alerts.tool.js.map +1 -0
- package/dist/mcp-server/tools/format-utils.d.ts +11 -0
- package/dist/mcp-server/tools/format-utils.d.ts.map +1 -0
- package/dist/mcp-server/tools/format-utils.js +27 -0
- package/dist/mcp-server/tools/format-utils.js.map +1 -0
- package/dist/services/nws/nws-service.d.ts +62 -0
- package/dist/services/nws/nws-service.d.ts.map +1 -0
- package/dist/services/nws/nws-service.js +372 -0
- package/dist/services/nws/nws-service.js.map +1 -0
- package/dist/services/nws/types.d.ts +96 -0
- package/dist/services/nws/types.d.ts.map +1 -0
- package/dist/services/nws/types.js +6 -0
- package/dist/services/nws/types.js.map +1 -0
- package/package.json +82 -0
- 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
|
+
}
|