mcp-new-caledonia
# mcp-new-caledonia
[](https://github.com/lacausecrypto/mcp-new-caledonia/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/mcp-new-caledonia)
[](https://www.npmjs.com/package/mcp-new-caledonia)
[](https://www.npmjs.com/package/mcp-new-caledonia)
[](https://github.com/lacausecrypto/mcp-new-caledonia/blob/main/LICENSE)
Compact MCP server for [data.gouv.nc](https://data.gouv.nc/), exposing New Caledonia public datasets over `stdio` for Claude Desktop and other MCP clients.
## What It Covers
- Public holidays
- Digital fragility index
- RIDET companies and establishments
- Employment and job market datasets
- Weather and rain station datasets
- Mining and metallurgical production
- Environment and coral reef monitoring
- Public facilities and vehicle statistics
- 2019 population census
- Tourism trails and Tanéo transport metadata
The server currently registers **29 tools** across **10 modules**.
## Why This Package
- No API key required
- Uses the official OpenDataSoft Explore v2.1 API
- Handles real-world schema drift in live datasets
- Returns explicit notes when a catalog entry exists but exposes no tabular records
- Ships as a simple Node.js CLI for MCP-compatible hosts
## Install
```bash
npm install -g mcp-new-caledonia
```
Or run directly with:
```bash
npx mcp-new-caledonia
```
## Claude Desktop
```json
{
"mcpServers": {
"new-caledonia": {
"command": "npx",
"args": ["mcp-new-caledonia"]
}
}
}
```
## Tool Groups
- `administration`: holidays, holiday checks, upcoming holidays, digital fragility
- `companies`: company search, company lookup, sector search, aggregates
- `employment`: job offers, job seeker stats, civil servants, partial unemployment
- `weather`: weather stations, rain stations
- `mining`: mining titles, metal production, Nickel Fund sites
- `environment`: water catchments, dry forest, piezometers, reef stations
- `geography`: public facilities, facility search, vehicle statistics
- `population`: census statistics, age demographics, transport modes
- `tourism`: GR trail data
- `transport`: Tanéo network information
## Local Development
```bash
npm install
npm run build
npm test
npm run dev
```
## Production Notes
- Runtime: Node.js 18+
- Transport: `stdio`
- Upstream API: `https://data.gouv.nc/api/explore/v2.1`
- Authentication: none
- Language of source data: mostly French
- Some datasets in the catalog are metadata-only or attachment-only; the server reports this cleanly instead of failing silently
## License
MIT
TDQS
Scored across 29 tools
Most tools have clearly distinct purposes, covering different domains like holidays, companies, mining, and census. A few pairs (e.g., nc_get_public_facilities vs. nc_search_facilities, nc_get_weather_stations vs. nc_get_rain_stations) could be confused, but their descriptions clarify the distinction. Overall, the risk of misselection is low.
All tools follow a strict pattern of `nc_` prefix followed by a lowercase verb (get, search, is) and a snake_case noun phrase. There is no mixing of camelCase or inconsistent verb styles. This makes the tool names predictable and easy to navigate.
With 29 tools, the count is above the typical heavy range (16-25), which could feel overwhelming. However, the server's scope is exceptionally broad, covering diverse public datasets from holidays to mining to transit. The count is justified by the wide domain, though it remains at the upper edge of appropriateness.
The tool surface provides strong coverage across the major data domains for New Caledonia, including companies, employment, environment, infrastructure, and demographics. Minor gaps exist, such as missing tools for education or tourism statistics, but the core workflows for the apparent purpose are well represented.