@bryance/noaa-free-mcp 1.0.3
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/README.md +79 -0
- package/dist/index.js +44 -0
- package/package.json +51 -0
package/README.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# NOAA Free MCP Server
|
|
2
|
+
|
|
3
|
+
A Model Context Protocol (MCP) server that provides access to NOAA precipitation data through an embedded Go binary. This server allows AI assistants to retrieve and analyze daily and monthly precipitation data from the NOAA Climate Prediction Center.
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- π§οΈ **Daily precipitation data** with detailed statistics (mean, median, mode, quartiles, outliers)
|
|
8
|
+
- π **Monthly precipitation totals** for any grid location
|
|
9
|
+
- πΊοΈ **13,626 valid grids** across CONUS (Continental United States) at 0.25Β° resolution
|
|
10
|
+
- π **Historical data** from 1947 to present
|
|
11
|
+
- β‘ **High performance** with embedded Go binary for data processing
|
|
12
|
+
- π **Real-time and historical** data support
|
|
13
|
+
- π₯οΈ **Cross-platform** support (Windows, macOS, Linux)
|
|
14
|
+
|
|
15
|
+
## Installation
|
|
16
|
+
|
|
17
|
+
### Global Installation (Recommended)
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npm install -g @bryance/noaa-free-mcp
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
### Local Installation
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install @bryance/noaa-free-mcp
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Configuration
|
|
30
|
+
|
|
31
|
+
Add the server to your MCP client configuration:
|
|
32
|
+
|
|
33
|
+
### Claude Desktop
|
|
34
|
+
|
|
35
|
+
Add to your `claude_desktop_config.json`:
|
|
36
|
+
|
|
37
|
+
```json
|
|
38
|
+
{
|
|
39
|
+
"mcpServers": {
|
|
40
|
+
"noaa-free": {
|
|
41
|
+
"command": "@bryance/noaa-free-mcp"
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Other MCP Clients
|
|
48
|
+
|
|
49
|
+
Use the command `@bryance/noaa-free-mcp` or the full path to the installed binary.
|
|
50
|
+
|
|
51
|
+
## Usage
|
|
52
|
+
|
|
53
|
+
The server provides two main tools:
|
|
54
|
+
|
|
55
|
+
### 1. Get Daily Rain Data
|
|
56
|
+
|
|
57
|
+
Retrieves daily precipitation measurements for a specific grid, year, and month.
|
|
58
|
+
|
|
59
|
+
**Parameters:**
|
|
60
|
+
- `grid_id` (6196-34941): NOAA grid identifier for valid CONUS grids
|
|
61
|
+
- `year` (1947-present): Year for data request
|
|
62
|
+
- `month` (1-12): Month for data request
|
|
63
|
+
|
|
64
|
+
**Returns:**
|
|
65
|
+
- Daily measurements for each day in the month
|
|
66
|
+
- Statistical analysis
|
|
67
|
+
|
|
68
|
+
### 2. Get Monthly Rain Total
|
|
69
|
+
|
|
70
|
+
Retrieves total precipitation for a specific grid, year, and month.
|
|
71
|
+
|
|
72
|
+
**Parameters:**
|
|
73
|
+
- `grid_id` (6196-34941): NOAA grid identifier for valid CONUS grids
|
|
74
|
+
- `year` (1947-present): Year for data request
|
|
75
|
+
- `month` (1-12): Month for data request
|
|
76
|
+
|
|
77
|
+
**Returns:**
|
|
78
|
+
- Total precipitation for the month
|
|
79
|
+
- Grid location information
|