@cyanheads/geonames-mcp-server 0.0.0-stage → 0.1.2

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 (91) hide show
  1. package/AGENTS.md +439 -0
  2. package/CLAUDE.md +439 -0
  3. package/Dockerfile +177 -0
  4. package/LICENSE +201 -0
  5. package/README.md +344 -2
  6. package/changelog/0.1.x/0.1.0.md +9 -0
  7. package/changelog/0.1.x/0.1.1.md +22 -0
  8. package/changelog/0.1.x/0.1.2.md +26 -0
  9. package/changelog/template.md +151 -0
  10. package/dist/config/server-config.d.ts +13 -0
  11. package/dist/config/server-config.d.ts.map +1 -0
  12. package/dist/config/server-config.js +21 -0
  13. package/dist/config/server-config.js.map +1 -0
  14. package/dist/index.d.ts +8 -0
  15. package/dist/index.d.ts.map +1 -0
  16. package/dist/index.js +30 -0
  17. package/dist/index.js.map +1 -0
  18. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.d.ts +96 -0
  19. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.d.ts.map +1 -0
  20. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.js +274 -0
  21. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.js.map +1 -0
  22. package/dist/mcp-server/tools/definitions/get-children.tool.d.ts +90 -0
  23. package/dist/mcp-server/tools/definitions/get-children.tool.d.ts.map +1 -0
  24. package/dist/mcp-server/tools/definitions/get-children.tool.js +287 -0
  25. package/dist/mcp-server/tools/definitions/get-children.tool.js.map +1 -0
  26. package/dist/mcp-server/tools/definitions/get-countries.tool.d.ts +90 -0
  27. package/dist/mcp-server/tools/definitions/get-countries.tool.d.ts.map +1 -0
  28. package/dist/mcp-server/tools/definitions/get-countries.tool.js +217 -0
  29. package/dist/mcp-server/tools/definitions/get-countries.tool.js.map +1 -0
  30. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.d.ts +64 -0
  31. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.d.ts.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.js +168 -0
  33. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.js.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-place.tool.d.ts +108 -0
  35. package/dist/mcp-server/tools/definitions/get-place.tool.d.ts.map +1 -0
  36. package/dist/mcp-server/tools/definitions/get-place.tool.js +300 -0
  37. package/dist/mcp-server/tools/definitions/get-place.tool.js.map +1 -0
  38. package/dist/mcp-server/tools/definitions/index.d.ts +760 -0
  39. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  40. package/dist/mcp-server/tools/definitions/index.js +23 -0
  41. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  42. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts +103 -0
  43. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -0
  44. package/dist/mcp-server/tools/definitions/list-reference.tool.js +233 -0
  45. package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -0
  46. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.d.ts +142 -0
  47. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.d.ts.map +1 -0
  48. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.js +421 -0
  49. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.js.map +1 -0
  50. package/dist/mcp-server/tools/definitions/search-places.tool.d.ts +145 -0
  51. package/dist/mcp-server/tools/definitions/search-places.tool.d.ts.map +1 -0
  52. package/dist/mcp-server/tools/definitions/search-places.tool.js +385 -0
  53. package/dist/mcp-server/tools/definitions/search-places.tool.js.map +1 -0
  54. package/dist/mcp-server/tools/shared-inputs.d.ts +140 -0
  55. package/dist/mcp-server/tools/shared-inputs.d.ts.map +1 -0
  56. package/dist/mcp-server/tools/shared-inputs.js +240 -0
  57. package/dist/mcp-server/tools/shared-inputs.js.map +1 -0
  58. package/dist/services/geonames/country-codes.d.ts +26 -0
  59. package/dist/services/geonames/country-codes.d.ts.map +1 -0
  60. package/dist/services/geonames/country-codes.js +284 -0
  61. package/dist/services/geonames/country-codes.js.map +1 -0
  62. package/dist/services/geonames/feature-codes.d.ts +27 -0
  63. package/dist/services/geonames/feature-codes.d.ts.map +1 -0
  64. package/dist/services/geonames/feature-codes.js +723 -0
  65. package/dist/services/geonames/feature-codes.js.map +1 -0
  66. package/dist/services/geonames/geonames-service.d.ts +103 -0
  67. package/dist/services/geonames/geonames-service.d.ts.map +1 -0
  68. package/dist/services/geonames/geonames-service.js +561 -0
  69. package/dist/services/geonames/geonames-service.js.map +1 -0
  70. package/dist/services/geonames/response-cache.d.ts +24 -0
  71. package/dist/services/geonames/response-cache.d.ts.map +1 -0
  72. package/dist/services/geonames/response-cache.js +44 -0
  73. package/dist/services/geonames/response-cache.js.map +1 -0
  74. package/dist/services/geonames/response-parsers.d.ts +38 -0
  75. package/dist/services/geonames/response-parsers.d.ts.map +1 -0
  76. package/dist/services/geonames/response-parsers.js +369 -0
  77. package/dist/services/geonames/response-parsers.js.map +1 -0
  78. package/dist/services/geonames/types.d.ts +226 -0
  79. package/dist/services/geonames/types.d.ts.map +1 -0
  80. package/dist/services/geonames/types.js +10 -0
  81. package/dist/services/geonames/types.js.map +1 -0
  82. package/dist/services/geonames/upstream-errors.d.ts +54 -0
  83. package/dist/services/geonames/upstream-errors.d.ts.map +1 -0
  84. package/dist/services/geonames/upstream-errors.js +187 -0
  85. package/dist/services/geonames/upstream-errors.js.map +1 -0
  86. package/dist/utils/inline-text.d.ts +25 -0
  87. package/dist/utils/inline-text.d.ts.map +1 -0
  88. package/dist/utils/inline-text.js +60 -0
  89. package/dist/utils/inline-text.js.map +1 -0
  90. package/package.json +108 -4
  91. package/server.json +120 -0
package/package.json CHANGED
@@ -1,6 +1,110 @@
1
1
  {
2
2
  "name": "@cyanheads/geonames-mcp-server",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.2",
4
+ "mcpName": "io.github.cyanheads/geonames-mcp-server",
5
+ "description": "Search GeoNames places, walk admin hierarchies, reverse geocode, get postal codes and country info via MCP. STDIO or Streamable HTTP.",
6
+ "type": "module",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "bin": {
10
+ "geonames-mcp-server": "dist/index.js"
11
+ },
12
+ "files": [
13
+ "changelog/",
14
+ "dist/",
15
+ "!dist/*.mcpb",
16
+ "README.md",
17
+ "LICENSE",
18
+ "CLAUDE.md",
19
+ "AGENTS.md",
20
+ "Dockerfile",
21
+ "server.json"
22
+ ],
23
+ "scripts": {
24
+ "build": "bun run scripts/build.ts",
25
+ "rebuild": "bun run scripts/clean.ts && bun run scripts/build.ts",
26
+ "clean": "bun run scripts/clean.ts",
27
+ "devcheck": "bun run scripts/devcheck.ts",
28
+ "audit:fix": "bun audit fix",
29
+ "audit:refresh": "rm -f bun.lock && bun install && bun audit",
30
+ "tree": "bun run scripts/tree.ts",
31
+ "list-skills": "bun run scripts/list-skills.ts",
32
+ "format": "biome check --write .",
33
+ "format:unsafe": "biome check --write --unsafe .",
34
+ "lint:mcp": "bun run scripts/lint-mcp.ts",
35
+ "lint:packaging": "bun run scripts/lint-packaging.ts",
36
+ "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/geonames-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/geonames-mcp-server.mcpb",
37
+ "changelog:build": "bun run scripts/build-changelog.ts",
38
+ "changelog:check": "bun run scripts/build-changelog.ts --check",
39
+ "release:github": "bun run scripts/release-github.ts",
40
+ "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
41
+ "test": "vitest run",
42
+ "test:coverage": "vitest run --coverage",
43
+ "start": "node dist/index.js",
44
+ "start:stdio": "MCP_TRANSPORT_TYPE=stdio node dist/index.js",
45
+ "start:http": "MCP_TRANSPORT_TYPE=http node dist/index.js"
46
+ },
47
+ "keywords": [
48
+ "mcp",
49
+ "mcp-server",
50
+ "model-context-protocol",
51
+ "typescript",
52
+ "bun",
53
+ "stdio",
54
+ "streamable-http",
55
+ "geonames",
56
+ "gazetteer",
57
+ "geography",
58
+ "geocoding",
59
+ "reverse-geocoding",
60
+ "postal-code",
61
+ "administrative-divisions",
62
+ "toponym"
63
+ ],
64
+ "repository": {
65
+ "type": "git",
66
+ "url": "git+https://github.com/cyanheads/geonames-mcp-server.git"
67
+ },
68
+ "homepage": "https://github.com/cyanheads/geonames-mcp-server#readme",
69
+ "bugs": {
70
+ "url": "https://github.com/cyanheads/geonames-mcp-server/issues"
71
+ },
72
+ "license": "Apache-2.0",
73
+ "packageManager": "bun@1.4.2",
74
+ "engines": {
75
+ "bun": ">=1.4.0",
76
+ "node": ">=24.0.0"
77
+ },
78
+ "publishConfig": {
79
+ "access": "public"
80
+ },
81
+ "dependencies": {
82
+ "@cyanheads/mcp-ts-core": "^0.13.10",
83
+ "pino-pretty": "^13.1.3",
84
+ "zod": "^4.6.5"
85
+ },
86
+ "devDependencies": {
87
+ "@biomejs/biome": "2.5.14",
88
+ "@modelcontextprotocol/server": "^2.2.0",
89
+ "@socketsecurity/bun-security-scanner": "^1.1.3",
90
+ "@types/node": "26.6.3",
91
+ "@vitest/coverage-istanbul": "5.0.2",
92
+ "depcheck": "^1.4.7",
93
+ "fast-check": "^4.10.2",
94
+ "ignore": "^7.0.10",
95
+ "tsc-alias": "^1.9.5",
96
+ "typescript": "^7.0.2",
97
+ "vitest": "^5.0.2"
98
+ },
99
+ "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
100
+ "funding": [
101
+ {
102
+ "type": "github",
103
+ "url": "https://github.com/sponsors/cyanheads"
104
+ },
105
+ {
106
+ "type": "buy_me_a_coffee",
107
+ "url": "https://www.buymeacoffee.com/cyanheads"
108
+ }
109
+ ]
110
+ }
package/server.json ADDED
@@ -0,0 +1,120 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/geonames-mcp-server",
4
+ "title": "geonames-mcp-server",
5
+ "description": "Search GeoNames places, walk admin hierarchies, reverse geocode, get postal codes and country info.",
6
+ "repository": {
7
+ "url": "https://github.com/cyanheads/geonames-mcp-server",
8
+ "source": "github"
9
+ },
10
+ "version": "0.1.2",
11
+ "remotes": [
12
+ {
13
+ "type": "streamable-http",
14
+ "url": "https://geonames.caseyjhand.com/mcp"
15
+ }
16
+ ],
17
+ "packages": [
18
+ {
19
+ "registryType": "npm",
20
+ "registryBaseUrl": "https://registry.npmjs.org",
21
+ "identifier": "@cyanheads/geonames-mcp-server",
22
+ "runtimeHint": "node",
23
+ "version": "0.1.2",
24
+ "packageArguments": [
25
+ {
26
+ "type": "positional",
27
+ "value": "run"
28
+ },
29
+ {
30
+ "type": "positional",
31
+ "value": "start:stdio"
32
+ }
33
+ ],
34
+ "environmentVariables": [
35
+ {
36
+ "name": "GEONAMES_USERNAME",
37
+ "description": "GeoNames account used when a call passes no geonamesUsername. Free accounts must enable free web services on their geonames.org account page.",
38
+ "format": "string",
39
+ "isRequired": false,
40
+ "isSecret": true
41
+ },
42
+ {
43
+ "name": "MCP_LOG_LEVEL",
44
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
45
+ "format": "string",
46
+ "isRequired": false,
47
+ "default": "info"
48
+ }
49
+ ],
50
+ "transport": {
51
+ "type": "stdio"
52
+ }
53
+ },
54
+ {
55
+ "registryType": "npm",
56
+ "registryBaseUrl": "https://registry.npmjs.org",
57
+ "identifier": "@cyanheads/geonames-mcp-server",
58
+ "runtimeHint": "node",
59
+ "version": "0.1.2",
60
+ "packageArguments": [
61
+ {
62
+ "type": "positional",
63
+ "value": "run"
64
+ },
65
+ {
66
+ "type": "positional",
67
+ "value": "start:http"
68
+ }
69
+ ],
70
+ "environmentVariables": [
71
+ {
72
+ "name": "GEONAMES_USERNAME",
73
+ "description": "GeoNames account used when a call passes no geonamesUsername. Free accounts must enable free web services on their geonames.org account page.",
74
+ "format": "string",
75
+ "isRequired": false,
76
+ "isSecret": true
77
+ },
78
+ {
79
+ "name": "MCP_HTTP_HOST",
80
+ "description": "The hostname for the HTTP server.",
81
+ "format": "string",
82
+ "isRequired": false,
83
+ "default": "127.0.0.1"
84
+ },
85
+ {
86
+ "name": "MCP_HTTP_PORT",
87
+ "description": "The port to run the HTTP server on.",
88
+ "format": "string",
89
+ "isRequired": false,
90
+ "default": "3010"
91
+ },
92
+ {
93
+ "name": "MCP_HTTP_ENDPOINT_PATH",
94
+ "description": "The endpoint path for the MCP server.",
95
+ "format": "string",
96
+ "isRequired": false,
97
+ "default": "/mcp"
98
+ },
99
+ {
100
+ "name": "MCP_AUTH_MODE",
101
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
102
+ "format": "string",
103
+ "isRequired": false,
104
+ "default": "none"
105
+ },
106
+ {
107
+ "name": "MCP_LOG_LEVEL",
108
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
109
+ "format": "string",
110
+ "isRequired": false,
111
+ "default": "info"
112
+ }
113
+ ],
114
+ "transport": {
115
+ "type": "streamable-http",
116
+ "url": "http://localhost:3010/mcp"
117
+ }
118
+ }
119
+ ]
120
+ }