@cyanheads/geonames-mcp-server 0.1.2 → 0.2.0
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/AGENTS.md +31 -17
- package/CLAUDE.md +31 -17
- package/Dockerfile +22 -7
- package/README.md +66 -122
- package/changelog/0.1.x/0.1.3.md +46 -0
- package/changelog/0.2.x/0.2.0.md +37 -0
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/find-postal-codes.tool.d.ts +8 -5
- package/dist/mcp-server/tools/definitions/find-postal-codes.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/find-postal-codes.tool.js +84 -42
- package/dist/mcp-server/tools/definitions/find-postal-codes.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-children.tool.d.ts +6 -0
- package/dist/mcp-server/tools/definitions/get-children.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-children.tool.js +35 -18
- package/dist/mcp-server/tools/definitions/get-children.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-countries.tool.d.ts +6 -0
- package/dist/mcp-server/tools/definitions/get-countries.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-countries.tool.js +32 -14
- package/dist/mcp-server/tools/definitions/get-countries.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-hierarchy.tool.js +3 -3
- package/dist/mcp-server/tools/definitions/get-hierarchy.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-place.tool.d.ts +3 -1
- package/dist/mcp-server/tools/definitions/get-place.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-place.tool.js +35 -11
- package/dist/mcp-server/tools/definitions/get-place.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +37 -5
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts +6 -0
- package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-reference.tool.js +34 -14
- package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/reverse-geocode.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/reverse-geocode.tool.js +85 -28
- package/dist/mcp-server/tools/definitions/reverse-geocode.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/search-places.tool.d.ts +12 -2
- package/dist/mcp-server/tools/definitions/search-places.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-places.tool.js +107 -26
- package/dist/mcp-server/tools/definitions/search-places.tool.js.map +1 -1
- package/dist/mcp-server/tools/shared-inputs.d.ts +62 -20
- package/dist/mcp-server/tools/shared-inputs.d.ts.map +1 -1
- package/dist/mcp-server/tools/shared-inputs.js +94 -29
- package/dist/mcp-server/tools/shared-inputs.js.map +1 -1
- package/dist/services/geonames/country-codes.d.ts +7 -1
- package/dist/services/geonames/country-codes.d.ts.map +1 -1
- package/dist/services/geonames/country-codes.js +15 -1
- package/dist/services/geonames/country-codes.js.map +1 -1
- package/dist/services/geonames/geonames-service.d.ts +7 -3
- package/dist/services/geonames/geonames-service.d.ts.map +1 -1
- package/dist/services/geonames/geonames-service.js +85 -35
- package/dist/services/geonames/geonames-service.js.map +1 -1
- package/dist/services/geonames/response-parsers.d.ts +9 -5
- package/dist/services/geonames/response-parsers.d.ts.map +1 -1
- package/dist/services/geonames/response-parsers.js +102 -22
- package/dist/services/geonames/response-parsers.js.map +1 -1
- package/dist/services/geonames/types.d.ts +30 -13
- package/dist/services/geonames/types.d.ts.map +1 -1
- package/dist/services/geonames/types.js +4 -3
- package/dist/services/geonames/types.js.map +1 -1
- package/dist/services/geonames/upstream-errors.d.ts.map +1 -1
- package/dist/services/geonames/upstream-errors.js +7 -7
- package/dist/services/geonames/upstream-errors.js.map +1 -1
- package/dist/utils/inline-text.d.ts +57 -12
- package/dist/utils/inline-text.d.ts.map +1 -1
- package/dist/utils/inline-text.js +137 -20
- package/dist/utils/inline-text.js.map +1 -1
- package/package.json +15 -13
- package/server.json +10 -24
- package/skills/geonames-guide/SKILL.md +64 -0
|
@@ -6,11 +6,13 @@
|
|
|
6
6
|
*/
|
|
7
7
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
8
8
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
9
|
-
import { blankAsUnset,
|
|
9
|
+
import { blankAsUnset, clampedLimitInput, clampLimit, geonamesUsernameInput, lowerCased, nameContainsInput, nameMatcher, offsetInput, paginate, UNSEARCHABLE_NAME_MESSAGE, USERNAME_ALIASES, } from '../shared-inputs.js';
|
|
10
10
|
import { FEATURE_CLASS_CODES, FEATURE_CLASS_LABELS, FEATURE_CODES, } from '../../../services/geonames/feature-codes.js';
|
|
11
11
|
import { getGeoNamesService } from '../../../services/geonames/geonames-service.js';
|
|
12
|
-
import {
|
|
12
|
+
import { renderNotice, tableCell } from '../../../utils/inline-text.js';
|
|
13
13
|
const TOPICS = ['feature_classes', 'feature_codes', 'postal_countries'];
|
|
14
|
+
/** The most entries one page returns; a larger `limit` is held to it. */
|
|
15
|
+
const MAX_LIMIT = 700;
|
|
14
16
|
const TOPIC_TITLES = {
|
|
15
17
|
feature_classes: 'feature classes',
|
|
16
18
|
feature_codes: 'feature codes',
|
|
@@ -41,10 +43,10 @@ export const listReferenceTool = tool('geonames_list_reference', {
|
|
|
41
43
|
description: "Decode GeoNames vocabulary used by the other tools: topic feature_classes lists the 9 one-letter classes; topic feature_codes lists the 684 feature codes with names and definitions, filterable by class and text; topic postal_countries lists the 122 countries with postal-code data and each one's code range and count. feature_classes and feature_codes are bundled and spend no credits; postal_countries costs 1 GeoNames credit a day (cached).",
|
|
42
44
|
annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
|
|
43
45
|
input: z.object({
|
|
44
|
-
topic: lowerCased(z.enum(TOPICS)).describe('Vocabulary to list: feature_classes (the 9 one-letter classes), feature_codes (the 684 codes), or postal_countries (countries with postal-code data).
|
|
45
|
-
featureClass: blankAsUnset(z.preprocess((value) => (typeof value === 'string' ? value.toUpperCase() : value), z.enum(FEATURE_CLASS_CODES).optional())).describe('Topic feature_codes only: keep the codes of this one-letter class (A, H, L, P, R, S, T, U, V).
|
|
46
|
-
nameContains: nameContainsInput.describe('Keep only entries whose code, name, or description contains every word of this text as a substring (port also matches airport), ignoring case, accents, and punctuation.'),
|
|
47
|
-
limit:
|
|
46
|
+
topic: lowerCased(z.enum(TOPICS)).describe('Vocabulary to list: feature_classes (the 9 one-letter classes), feature_codes (the 684 codes), or postal_countries (countries with postal-code data).'),
|
|
47
|
+
featureClass: blankAsUnset(z.preprocess((value) => (typeof value === 'string' ? value.toUpperCase() : value), z.enum(FEATURE_CLASS_CODES).optional())).describe('Topic feature_codes only: keep the codes of this one-letter class (A, H, L, P, R, S, T, U, V).'),
|
|
48
|
+
nameContains: nameContainsInput.describe('Keep only entries whose code, name, or description contains every word of this text as a substring (port also matches airport), ignoring case, accents, and punctuation. Give at least one letter or digit.'),
|
|
49
|
+
limit: clampedLimitInput(MAX_LIMIT, 100),
|
|
48
50
|
offset: offsetInput(),
|
|
49
51
|
geonamesUsername: geonamesUsernameInput.describe("Topic postal_countries only, and only when the list is not already cached: your own GeoNames username, so the call spends that account's credit instead of the server's. The account needs free web services enabled on its geonames.org account page."),
|
|
50
52
|
}),
|
|
@@ -89,12 +91,13 @@ export const listReferenceTool = tool('geonames_list_reference', {
|
|
|
89
91
|
totalCount: z.number().describe('Entries matching the topic and filters, before paging.'),
|
|
90
92
|
truncated: z.boolean().describe('True when more entries remain past this page.'),
|
|
91
93
|
shown: z.number().describe('Entries returned on this page.'),
|
|
92
|
-
cap: z.number().describe('The limit
|
|
94
|
+
cap: z.number().describe('The limit applied: limit as given, or 700 when it asked for more.'),
|
|
93
95
|
notice: z
|
|
94
96
|
.string()
|
|
95
97
|
.optional()
|
|
96
|
-
.describe('Guidance when nothing matched, the offset is past the end, or more pages remain.'),
|
|
98
|
+
.describe('Guidance when nothing matched, the offset is past the end, or more pages remain (naming a limit held to 700).'),
|
|
97
99
|
},
|
|
100
|
+
enrichmentTrailer: { notice: { render: renderNotice } },
|
|
98
101
|
errors: [
|
|
99
102
|
{
|
|
100
103
|
reason: 'filter_not_applicable',
|
|
@@ -103,6 +106,13 @@ export const listReferenceTool = tool('geonames_list_reference', {
|
|
|
103
106
|
recovery: 'Drop featureClass, or call geonames_list_reference with topic feature_codes to filter codes by class.',
|
|
104
107
|
severity: 'notice',
|
|
105
108
|
},
|
|
109
|
+
{
|
|
110
|
+
reason: 'name_contains_unsearchable',
|
|
111
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
112
|
+
when: 'nameContains is not blank but holds no letter or digit (only punctuation, symbols, emoji, or invisible characters), so it would match every entry.',
|
|
113
|
+
recovery: 'Pass at least one letter or digit of the code, name, or description in nameContains, or omit nameContains to list every entry.',
|
|
114
|
+
severity: 'notice',
|
|
115
|
+
},
|
|
106
116
|
{
|
|
107
117
|
reason: 'username_required',
|
|
108
118
|
code: JsonRpcErrorCode.Unauthorized,
|
|
@@ -144,10 +154,15 @@ export const listReferenceTool = tool('geonames_list_reference', {
|
|
|
144
154
|
},
|
|
145
155
|
],
|
|
146
156
|
async handler(input, ctx) {
|
|
147
|
-
|
|
157
|
+
const limit = clampLimit(input.limit, MAX_LIMIT);
|
|
158
|
+
ctx.enrich({ totalCount: 0, truncated: false, shown: 0, cap: limit.applied });
|
|
148
159
|
if (input.featureClass !== undefined && input.topic !== 'feature_codes') {
|
|
149
160
|
throw ctx.fail('filter_not_applicable', `featureClass applies only to topic feature_codes, not ${input.topic}.`);
|
|
150
161
|
}
|
|
162
|
+
const matcher = input.nameContains === undefined ? undefined : nameMatcher(input.nameContains);
|
|
163
|
+
if (input.nameContains !== undefined && matcher === undefined) {
|
|
164
|
+
throw ctx.fail('name_contains_unsearchable', UNSEARCHABLE_NAME_MESSAGE);
|
|
165
|
+
}
|
|
151
166
|
let entries;
|
|
152
167
|
switch (input.topic) {
|
|
153
168
|
case 'feature_classes':
|
|
@@ -170,18 +185,23 @@ export const listReferenceTool = tool('geonames_list_reference', {
|
|
|
170
185
|
break;
|
|
171
186
|
}
|
|
172
187
|
}
|
|
173
|
-
const matcher = input.nameContains === undefined ? undefined : nameMatcher(input.nameContains);
|
|
174
188
|
const matches = matcher
|
|
175
189
|
? entries.filter((entry) => matcher([entry.code, entry.name, entry.description]))
|
|
176
190
|
: entries;
|
|
177
|
-
const { page, nextOffset } = paginate(matches, input.offset,
|
|
191
|
+
const { page, nextOffset } = paginate(matches, input.offset, limit.applied);
|
|
178
192
|
ctx.enrich.total(matches.length);
|
|
179
193
|
ctx.enrich({ shown: page.length });
|
|
180
194
|
if (nextOffset !== undefined) {
|
|
195
|
+
const remaining = matches.length - nextOffset;
|
|
181
196
|
ctx.enrich.truncated({
|
|
182
197
|
shown: page.length,
|
|
183
|
-
cap:
|
|
184
|
-
guidance:
|
|
198
|
+
cap: limit.applied,
|
|
199
|
+
guidance: [
|
|
200
|
+
limit.fragment,
|
|
201
|
+
`${remaining} more ${remaining === 1 ? 'entry' : 'entries'}; call again with offset ${nextOffset}.`,
|
|
202
|
+
]
|
|
203
|
+
.filter(Boolean)
|
|
204
|
+
.join(' '),
|
|
185
205
|
});
|
|
186
206
|
}
|
|
187
207
|
if (page.length === 0) {
|
|
@@ -192,7 +212,7 @@ export const listReferenceTool = tool('geonames_list_reference', {
|
|
|
192
212
|
ctx.enrich.notice(`offset ${input.offset} is past the last entry (${matches.length}); call again with a smaller offset.`);
|
|
193
213
|
}
|
|
194
214
|
else if (input.nameContains !== undefined) {
|
|
195
|
-
ctx.enrich.notice(`Nothing in ${scope} matches "${
|
|
215
|
+
ctx.enrich.notice(`Nothing in ${scope} matches "${input.nameContains}"; call again without nameContains.`);
|
|
196
216
|
}
|
|
197
217
|
}
|
|
198
218
|
return {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"list-reference.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-reference.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,YAAY,EACZ,
|
|
1
|
+
{"version":3,"file":"list-reference.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-reference.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"reverse-geocode.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/reverse-geocode.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"reverse-geocode.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/reverse-geocode.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAsGjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4gB7B,CAAC"}
|
|
@@ -8,18 +8,52 @@
|
|
|
8
8
|
*/
|
|
9
9
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
10
10
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
11
|
-
import { blankAsUnset, citiesInput, featureClassesInput, featureCodesInput, featureFilterMismatch, geonamesUsernameInput, latInput, lngInput, USERNAME_ALIASES, } from '../shared-inputs.js';
|
|
11
|
+
import { blankAsUnset, citiesInput, clampLimit, featureClassesInput, featureCodesInput, featureFilterMismatch, geonamesUsernameInput, latInput, lngInput, USERNAME_ALIASES, } from '../shared-inputs.js';
|
|
12
12
|
import { getFeatureCode } from '../../../services/geonames/feature-codes.js';
|
|
13
13
|
import { getGeoNamesService } from '../../../services/geonames/geonames-service.js';
|
|
14
|
-
import { inlineText, tableCell } from '../../../utils/inline-text.js';
|
|
14
|
+
import { inlineText, renderNotice, tableCell } from '../../../utils/inline-text.js';
|
|
15
15
|
/** Wall-clock budget for the whole call, inside a 60 s client timeout. */
|
|
16
16
|
const TOOL_BUDGET_MS = 30_000;
|
|
17
17
|
/** Ceiling on the ocean follow-up's ladder; it also gets no more than what the budget has left. */
|
|
18
18
|
const OCEAN_BUDGET_MS = 10_000;
|
|
19
|
-
/** The most nearby rows one call returns. */
|
|
19
|
+
/** The most nearby rows one call returns; a larger nearbyLimit is held to it. */
|
|
20
20
|
const MAX_NEARBY = 50;
|
|
21
|
+
/** The largest nearbyLimit accepted; anything above it fails validation as absurd. */
|
|
22
|
+
const NEARBY_LIMIT_CEILING = 1000;
|
|
21
23
|
/** GeoNames' free-tier ceiling on the nearby radius (status 24 beyond). */
|
|
22
24
|
const MAX_RADIUS_KM = 300;
|
|
25
|
+
/** Page size the full-page recipe asks geonames_search_places for: its per-call maximum. */
|
|
26
|
+
const SEARCH_PAGE = 100;
|
|
27
|
+
/** Mean Earth radius in km: the sphere the full-page recipe's box is drawn on. */
|
|
28
|
+
const EARTH_RADIUS_KM = 6371;
|
|
29
|
+
/**
|
|
30
|
+
* Factor on radiusKm for that box. GeoNames' nearby distances run up to 0.2% shorter than
|
|
31
|
+
* the haversine distance on this sphere (0.03% around Paris, 0.19% around Fiji), so an exact
|
|
32
|
+
* box can miss a row GeoNames places just inside the radius; 1% more keeps it in.
|
|
33
|
+
*/
|
|
34
|
+
const BOX_MARGIN = 1.01;
|
|
35
|
+
const DEGREES = 180 / Math.PI;
|
|
36
|
+
/** Rounds a bound outward to 4 decimals (about 11 m), so rounding never shrinks the box. */
|
|
37
|
+
const ceil4 = (value) => Math.ceil(value * 1e4) / 1e4;
|
|
38
|
+
const floor4 = (value) => Math.floor(value * 1e4) / 1e4;
|
|
39
|
+
/**
|
|
40
|
+
* The geonames_search_places boundingBox enclosing radiusKm around a point. A circle that
|
|
41
|
+
* takes in a pole spans every longitude; one that crosses the 180° meridian has no single
|
|
42
|
+
* box search accepts (west below east), so it gets none.
|
|
43
|
+
*/
|
|
44
|
+
function radiusBox(lat, lng, radiusKm) {
|
|
45
|
+
const angle = (radiusKm * BOX_MARGIN) / EARTH_RADIUS_KM;
|
|
46
|
+
const north = Math.min(90, ceil4(lat + angle * DEGREES));
|
|
47
|
+
const south = Math.max(-90, floor4(lat - angle * DEGREES));
|
|
48
|
+
/** sin(longitude half-span) of a spherical cap; at 1 or more the cap holds a pole. */
|
|
49
|
+
const spanSine = Math.sin(angle) / Math.cos(lat / DEGREES);
|
|
50
|
+
if (spanSine >= 1)
|
|
51
|
+
return { north, south, east: 180, west: -180 };
|
|
52
|
+
const span = Math.asin(spanSine) * DEGREES;
|
|
53
|
+
const east = ceil4(lng + span);
|
|
54
|
+
const west = floor4(lng - span);
|
|
55
|
+
return east > 180 || west < -180 ? undefined : { north, south, east, west };
|
|
56
|
+
}
|
|
23
57
|
/**
|
|
24
58
|
* Ceiling on the containment buffer: room for harbors, estuaries, and the 12-nautical-mile
|
|
25
59
|
* territorial sea, and well below the 300 km GeoNames rejects with status 24.
|
|
@@ -43,11 +77,11 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
43
77
|
input: z.object({
|
|
44
78
|
lat: latInput,
|
|
45
79
|
lng: lngInput,
|
|
46
|
-
nearbyLimit: blankAsUnset(z.number().int().min(0).max(
|
|
80
|
+
nearbyLimit: blankAsUnset(z.number().int().min(0).max(NEARBY_LIMIT_CEILING).default(5)).describe('How many nearest places or features to list, 0 to 1,000. This tool returns at most 50 per call: a larger nearbyLimit is held to 50, and the notice says so when more lie within the radius. Default 5. 0 skips the nearby lookup and its 3 or 4 credits.'),
|
|
47
81
|
radiusKm: blankAsUnset(z.number().positive().max(MAX_RADIUS_KM).default(20)).describe("Radius in kilometres for the nearby lookup, above 0 and at most 300 (GeoNames' free-tier limit). Default 20."),
|
|
48
|
-
cities: citiesInput.describe("Keep only nearby populated places with a population of at least 1,000 (cities1000), 5,000 (cities5000), or 15,000 (cities15000), plus seats of admin divisions: GeoNames' cities tiers. Not combinable with featureClasses or featureCodes."),
|
|
49
|
-
featureClasses: featureClassesInput.describe('List the nearest features of these GeoNames classes instead of populated places: A admin divisions, H water, L areas, P populated places, R roads, S spots and buildings, T terrain, U undersea, V vegetation.
|
|
50
|
-
featureCodes: featureCodesInput.describe("List the nearest features with these GeoNames codes instead of populated places (MT mountain, PK peak, LK lake, AIRP airport), up to 20, as a list
|
|
82
|
+
cities: citiesInput.describe("Keep only nearby populated places with a population of at least 1,000 (cities1000), 5,000 (cities5000), or 15,000 (cities15000), plus seats of admin divisions: GeoNames' cities tiers. A city's sections (PPLX) with their own population pass too. Not combinable with featureClasses or featureCodes."),
|
|
83
|
+
featureClasses: featureClassesInput.describe('List the nearest features of these GeoNames classes instead of populated places: A admin divisions, H water, L areas, P populated places, R roads, S spots and buildings, T terrain, U undersea, V vegetation. With featureCodes too, the two lists intersect: list exactly the classes of those codes, or pass featureCodes alone. Not combinable with cities.'),
|
|
84
|
+
featureCodes: featureCodesInput.describe("List the nearest features with these GeoNames codes instead of populated places (MT mountain, PK peak, LK lake, AIRP airport), up to 20, as a list. Each code implies its class; with featureClasses too, the two lists intersect, so featureClasses must list exactly these codes' classes. geonames_list_reference topic feature_codes lists every code. Not combinable with cities."),
|
|
51
85
|
includeTimezone: blankAsUnset(z.boolean().default(false)).describe('Also return the timezone: IANA id, UTC offsets, local time, sunrise, and sunset (1 more credit). Default false.'),
|
|
52
86
|
coastalBufferKm: blankAsUnset(z.number().min(0).max(MAX_COASTAL_BUFFER_KM).default(0)).describe("When no country contains the point, match the nearest country within this many kilometres, 0 to 50. Default 0: exact containment only. Set it for a harbor, pier, or shoreline point, which can fall just outside a country's outline as GeoNames maps it and otherwise resolves to the sea; a match carries country.distanceInKm. The nearby and timezone lookups keep the exact point. No extra credit."),
|
|
53
87
|
geonamesUsername: geonamesUsernameInput,
|
|
@@ -74,7 +108,10 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
74
108
|
.array(z
|
|
75
109
|
.object({
|
|
76
110
|
level: z.number().describe('Admin level: 1 for the first-order division, up to 5.'),
|
|
77
|
-
code: z
|
|
111
|
+
code: z
|
|
112
|
+
.string()
|
|
113
|
+
.optional()
|
|
114
|
+
.describe("GeoNames admin code at this level. At levels 1 to 4, pass it as written to geonames_search_places as that level's adminCode (adminCode1 to adminCode4), with the level 1 code as adminCode1 and country.countryCode in countries, to search inside the division; level 5 has no search filter."),
|
|
78
115
|
name: z.string().optional().describe('Name of the division.'),
|
|
79
116
|
geonameId: z
|
|
80
117
|
.number()
|
|
@@ -157,10 +194,12 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
157
194
|
.optional()
|
|
158
195
|
.describe('ISO 3166-1 alpha-2 code of the timezone country. Absent offshore.'),
|
|
159
196
|
rawOffsetInHours: z.number().describe('Standard UTC offset in hours, without DST.'),
|
|
160
|
-
gmtOffsetInHours: z
|
|
197
|
+
gmtOffsetInHours: z
|
|
198
|
+
.number()
|
|
199
|
+
.describe('UTC offset in hours on 1 January of the current local year.'),
|
|
161
200
|
dstOffsetInHours: z
|
|
162
201
|
.number()
|
|
163
|
-
.describe("UTC offset in hours on 1 July. Without a timezoneId the offsets are GeoNames' open-water estimate, which has no DST, so
|
|
202
|
+
.describe("UTC offset in hours on 1 July of the current local year. Without a timezoneId the offsets are GeoNames' open-water estimate, which has no DST, so both equal rawOffsetInHours."),
|
|
164
203
|
localTime: z
|
|
165
204
|
.string()
|
|
166
205
|
.optional()
|
|
@@ -168,11 +207,11 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
168
207
|
sunrise: z
|
|
169
208
|
.string()
|
|
170
209
|
.optional()
|
|
171
|
-
.describe("
|
|
210
|
+
.describe("Local sunrise on localTime's date, YYYY-MM-DD HH:mm. Absent offshore, in polar day or night, and when GeoNames has none for that date."),
|
|
172
211
|
sunset: z
|
|
173
212
|
.string()
|
|
174
213
|
.optional()
|
|
175
|
-
.describe(
|
|
214
|
+
.describe('Local sunset of the same day as sunrise, YYYY-MM-DD HH:mm; it can fall after midnight. Absent offshore, in polar day or night, and when GeoNames has none for that date.'),
|
|
176
215
|
})
|
|
177
216
|
.optional()
|
|
178
217
|
.describe('The timezone at the point; present only with includeTimezone.'),
|
|
@@ -180,14 +219,17 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
180
219
|
enrichment: {
|
|
181
220
|
truncated: z
|
|
182
221
|
.boolean()
|
|
183
|
-
.describe('True when
|
|
222
|
+
.describe('True when more places or features lie within the radius than nearby holds.'),
|
|
184
223
|
shown: z.number().describe('Nearby places or features returned.'),
|
|
185
|
-
cap: z
|
|
224
|
+
cap: z
|
|
225
|
+
.number()
|
|
226
|
+
.describe('The nearbyLimit applied: nearbyLimit as given, or 50 when it asked for more.'),
|
|
186
227
|
notice: z
|
|
187
228
|
.string()
|
|
188
229
|
.optional()
|
|
189
|
-
.describe('Guidance when the point is offshore or unmapped, its country was matched within coastalBufferKm, nothing is nearby, nearby
|
|
230
|
+
.describe('Guidance when the point is offshore or unmapped, its country was matched within coastalBufferKm, nothing is nearby, more lie within the radius than nearby holds (naming a nearbyLimit held to 50, and past 50 the geonames_search_places call that lists the rest), or no IANA timezone covers it.'),
|
|
190
231
|
},
|
|
232
|
+
enrichmentTrailer: { notice: { render: renderNotice } },
|
|
191
233
|
errors: [
|
|
192
234
|
{
|
|
193
235
|
reason: 'unknown_feature_code',
|
|
@@ -252,8 +294,10 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
252
294
|
],
|
|
253
295
|
async handler(input, ctx) {
|
|
254
296
|
const startedAt = Date.now();
|
|
255
|
-
|
|
256
|
-
const
|
|
297
|
+
const clamp = clampLimit(input.nearbyLimit, MAX_NEARBY, 'nearbyLimit');
|
|
298
|
+
const nearbyLimit = clamp.applied;
|
|
299
|
+
ctx.enrich({ truncated: false, shown: 0, cap: nearbyLimit });
|
|
300
|
+
const { lat, lng, radiusKm, cities, featureClasses, featureCodes, coastalBufferKm } = input;
|
|
257
301
|
if (cities !== undefined && (featureClasses !== undefined || featureCodes !== undefined)) {
|
|
258
302
|
throw ctx.fail('conflicting_filters', 'cities narrows the nearest populated places, while featureClasses and featureCodes switch to the nearest features of a type; pass one or the other.');
|
|
259
303
|
}
|
|
@@ -286,7 +330,8 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
286
330
|
});
|
|
287
331
|
return ocean === undefined ? {} : { ocean };
|
|
288
332
|
};
|
|
289
|
-
|
|
333
|
+
/** One row past nearbyLimit: the extra row is what says more lie within the radius. */
|
|
334
|
+
const nearbyParams = { lat, lng, radiusKm, limit: nearbyLimit + 1 };
|
|
290
335
|
let nearbyLeg = Promise.resolve([]);
|
|
291
336
|
if (nearbyKind === 'populated_places') {
|
|
292
337
|
nearbyLeg = service.nearbyPlaces({ ...nearbyParams, cities }, account, ctx);
|
|
@@ -294,18 +339,19 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
294
339
|
else if (nearbyKind === 'features') {
|
|
295
340
|
nearbyLeg = service.nearbyFeatures({ ...nearbyParams, featureClasses, featureCodes }, account, ctx);
|
|
296
341
|
}
|
|
297
|
-
const [{ subdivision, ocean },
|
|
342
|
+
const [{ subdivision, ocean }, nearbyRows, timezone] = await Promise.all([
|
|
298
343
|
locate(),
|
|
299
344
|
nearbyLeg,
|
|
300
345
|
input.includeTimezone ? service.timezone(lat, lng, account, ctx) : undefined,
|
|
301
346
|
]);
|
|
347
|
+
const nearby = nearbyRows.slice(0, nearbyLimit);
|
|
302
348
|
const shown = nearby.length;
|
|
303
349
|
ctx.enrich({ shown });
|
|
304
350
|
const fragments = [];
|
|
305
351
|
if (subdivision === undefined && ocean !== undefined) {
|
|
306
352
|
fragments.push(coastalBufferKm > 0
|
|
307
|
-
? `No country lies within ${coastalBufferKm} km of this point; it lies in ${
|
|
308
|
-
: `No country contains this point; it lies in ${
|
|
353
|
+
? `No country lies within ${coastalBufferKm} km of this point; it lies in ${ocean.name}.`
|
|
354
|
+
: `No country contains this point; it lies in ${ocean.name}. A harbor or shoreline point just outside a country's outline resolves to the water body: set coastalBufferKm (up to ${MAX_COASTAL_BUFFER_KM}) to match the nearest country within that distance.`);
|
|
309
355
|
}
|
|
310
356
|
else if (subdivision === undefined) {
|
|
311
357
|
const noCountry = coastalBufferKm > 0
|
|
@@ -318,9 +364,7 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
318
364
|
}
|
|
319
365
|
else if (subdivision.country?.distanceInKm !== undefined) {
|
|
320
366
|
const { countryCode, countryName, distanceInKm } = subdivision.country;
|
|
321
|
-
const label = countryName === undefined
|
|
322
|
-
? inlineText(countryCode)
|
|
323
|
-
: `${inlineText(countryName)} (${inlineText(countryCode)})`;
|
|
367
|
+
const label = countryName === undefined ? countryCode : `${countryName} (${countryCode})`;
|
|
324
368
|
fragments.push(`No country contains this point exactly; ${label} was matched ${distanceInKm} km away, within the ${coastalBufferKm} km coastal buffer.`);
|
|
325
369
|
}
|
|
326
370
|
const widen = radiusKm < MAX_RADIUS_KM
|
|
@@ -336,11 +380,24 @@ export const reverseGeocodeTool = tool('geonames_reverse_geocode', {
|
|
|
336
380
|
: `with code ${featureCodes.join(', ')}`;
|
|
337
381
|
fragments.push(`No feature ${filter} within ${radiusKm} km; ${widen} or widen the feature filter (geonames_list_reference topic feature_codes).`);
|
|
338
382
|
}
|
|
339
|
-
if (
|
|
383
|
+
if (nearbyRows.length > nearbyLimit) {
|
|
340
384
|
ctx.enrich.truncated({ shown, cap: nearbyLimit });
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
385
|
+
if (clamp.fragment !== undefined)
|
|
386
|
+
fragments.push(clamp.fragment);
|
|
387
|
+
if (nearbyLimit < MAX_NEARBY) {
|
|
388
|
+
fragments.push(`Only the nearest ${nearbyLimit} are listed, and more lie within ${radiusKm} km; raise nearbyLimit (max ${MAX_NEARBY}) to see them.`);
|
|
389
|
+
}
|
|
390
|
+
else {
|
|
391
|
+
/** The search filter that selects what this nearby lookup lists. */
|
|
392
|
+
const filter = nearbyKind === 'features'
|
|
393
|
+
? { featureClasses, featureCodes }
|
|
394
|
+
: { featureClasses: ['P'], cities };
|
|
395
|
+
const box = radiusBox(lat, lng, radiusKm);
|
|
396
|
+
const keep = `read every page (the search reaches its first 5,100 rows; split a box whose totalCount runs past that) and keep the rows whose lat and lng lie within ${radiusKm} km of this point`;
|
|
397
|
+
fragments.push(`Only the nearest ${MAX_NEARBY} are listed, ${clamp.fragment === undefined ? 'the most one call returns, ' : ''}and more lie within ${radiusKm} km.`, box === undefined
|
|
398
|
+
? `To list them all, call geonames_search_places with ${JSON.stringify({ ...filter, limit: SEARCH_PAGE })} and a boundingBox on each side of the 180° meridian, which the radius crosses and one box cannot span; the search lists rows in relevance order, not by distance, so ${keep}.`
|
|
399
|
+
: `To list them all, call geonames_search_places with ${JSON.stringify({ ...filter, boundingBox: box, limit: SEARCH_PAGE })}: the box encloses the radius, but the search lists its rows in relevance order, not by distance, so ${keep}.`);
|
|
400
|
+
}
|
|
344
401
|
}
|
|
345
402
|
if (input.includeTimezone && timezone?.timezoneId === undefined) {
|
|
346
403
|
fragments.push(timezone === undefined
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"reverse-geocode.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/reverse-geocode.tool.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"reverse-geocode.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/reverse-geocode.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview geonames_search_places — searches the GeoNames gazetteer by name and
|
|
3
|
-
* filters (country, feature class or code, population tier, bounding box) through
|
|
3
|
+
* filters (country, admin code, feature class or code, population tier, bounding box) through
|
|
4
4
|
* `searchJSON`, one credit a call, cached for an hour.
|
|
5
5
|
* @module mcp-server/tools/definitions/search-places.tool
|
|
6
6
|
*/
|
|
@@ -15,6 +15,10 @@ export declare const searchPlacesTool: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
15
15
|
name_required: "name_required";
|
|
16
16
|
}>>, unknown>, unknown>;
|
|
17
17
|
countries: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodString>>, unknown>;
|
|
18
|
+
adminCode1: z.ZodPreprocess<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, unknown>;
|
|
19
|
+
adminCode2: z.ZodPreprocess<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, unknown>;
|
|
20
|
+
adminCode3: z.ZodPreprocess<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, unknown>;
|
|
21
|
+
adminCode4: z.ZodPreprocess<z.ZodPreprocess<z.ZodOptional<z.ZodString>, unknown>, unknown>;
|
|
18
22
|
featureClasses: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
|
|
19
23
|
A: "A";
|
|
20
24
|
H: "H";
|
|
@@ -79,7 +83,7 @@ export declare const searchPlacesTool: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
79
83
|
}, {
|
|
80
84
|
readonly reason: "unknown_country_code";
|
|
81
85
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
82
|
-
readonly when: "A countries entry
|
|
86
|
+
readonly when: "A countries entry, once mapped to alpha-2, is none of the 250 country codes or the retired AN, CS, and YU: an alpha-2 such as EL or EU, or an unassigned alpha-3 or numeric code.";
|
|
83
87
|
readonly recovery: "Find the country with geonames_get_countries (nameContains matches its name), then call again with its alpha-2, alpha-3, or numeric code.";
|
|
84
88
|
readonly severity: "notice";
|
|
85
89
|
}, {
|
|
@@ -88,6 +92,12 @@ export declare const searchPlacesTool: import("@cyanheads/mcp-ts-core").ToolDefi
|
|
|
88
92
|
readonly when: "A featureCodes entry is not a GeoNames feature code.";
|
|
89
93
|
readonly recovery: "Look up valid codes with geonames_list_reference topic feature_codes, then retry with a listed code.";
|
|
90
94
|
readonly severity: "notice";
|
|
95
|
+
}, {
|
|
96
|
+
readonly reason: "admin_code_unscoped";
|
|
97
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
98
|
+
readonly when: "An admin code is set without exactly one country in countries, or adminCode2 to adminCode4 without adminCode1: codes repeat across countries, and lower-level codes across first-level divisions.";
|
|
99
|
+
readonly recovery: "Call geonames_search_places again with exactly one country in countries and, beside adminCode2 to adminCode4, the adminCode1 they belong to; geonames_get_place lists the codes of every level in adminLevels.";
|
|
100
|
+
readonly severity: "notice";
|
|
91
101
|
}, {
|
|
92
102
|
readonly reason: "feature_filter_mismatch";
|
|
93
103
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-places.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-places.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"search-places.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-places.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA4GjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+d3B,CAAC"}
|