@cyanheads/openstreetmap-mcp-server 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.
Files changed (62) hide show
  1. package/CLAUDE.md +393 -0
  2. package/Dockerfile +99 -0
  3. package/LICENSE +201 -0
  4. package/README.md +283 -0
  5. package/dist/config/server-config.d.ts +14 -0
  6. package/dist/config/server-config.d.ts.map +1 -0
  7. package/dist/config/server-config.js +47 -0
  8. package/dist/config/server-config.js.map +1 -0
  9. package/dist/index.d.ts +7 -0
  10. package/dist/index.d.ts.map +1 -0
  11. package/dist/index.js +40 -0
  12. package/dist/index.js.map +1 -0
  13. package/dist/mcp-server/tools/definitions/openstreetmap-format.d.ts +18 -0
  14. package/dist/mcp-server/tools/definitions/openstreetmap-format.d.ts.map +1 -0
  15. package/dist/mcp-server/tools/definitions/openstreetmap-format.js +36 -0
  16. package/dist/mcp-server/tools/definitions/openstreetmap-format.js.map +1 -0
  17. package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.d.ts +59 -0
  18. package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.d.ts.map +1 -0
  19. package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.js +203 -0
  20. package/dist/mcp-server/tools/definitions/openstreetmap-geocode.tool.js.map +1 -0
  21. package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.d.ts +39 -0
  22. package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.d.ts.map +1 -0
  23. package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.js +136 -0
  24. package/dist/mcp-server/tools/definitions/openstreetmap-lookup.tool.js.map +1 -0
  25. package/dist/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.d.ts +57 -0
  26. package/dist/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.d.ts.map +1 -0
  27. package/dist/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.js +170 -0
  28. package/dist/mcp-server/tools/definitions/openstreetmap-query-bbox.tool.js.map +1 -0
  29. package/dist/mcp-server/tools/definitions/openstreetmap-query-nearby.tool.d.ts +56 -0
  30. package/dist/mcp-server/tools/definitions/openstreetmap-query-nearby.tool.d.ts.map +1 -0
  31. package/dist/mcp-server/tools/definitions/openstreetmap-query-nearby.tool.js +174 -0
  32. package/dist/mcp-server/tools/definitions/openstreetmap-query-nearby.tool.js.map +1 -0
  33. package/dist/mcp-server/tools/definitions/openstreetmap-query-raw.tool.d.ts +38 -0
  34. package/dist/mcp-server/tools/definitions/openstreetmap-query-raw.tool.d.ts.map +1 -0
  35. package/dist/mcp-server/tools/definitions/openstreetmap-query-raw.tool.js +124 -0
  36. package/dist/mcp-server/tools/definitions/openstreetmap-query-raw.tool.js.map +1 -0
  37. package/dist/mcp-server/tools/definitions/openstreetmap-reverse.tool.d.ts +40 -0
  38. package/dist/mcp-server/tools/definitions/openstreetmap-reverse.tool.d.ts.map +1 -0
  39. package/dist/mcp-server/tools/definitions/openstreetmap-reverse.tool.js +129 -0
  40. package/dist/mcp-server/tools/definitions/openstreetmap-reverse.tool.js.map +1 -0
  41. package/dist/mcp-server/tools/definitions/openstreetmap-tag-input.d.ts +21 -0
  42. package/dist/mcp-server/tools/definitions/openstreetmap-tag-input.d.ts.map +1 -0
  43. package/dist/mcp-server/tools/definitions/openstreetmap-tag-input.js +22 -0
  44. package/dist/mcp-server/tools/definitions/openstreetmap-tag-input.js.map +1 -0
  45. package/dist/services/nominatim/nominatim-service.d.ts +24 -0
  46. package/dist/services/nominatim/nominatim-service.d.ts.map +1 -0
  47. package/dist/services/nominatim/nominatim-service.js +160 -0
  48. package/dist/services/nominatim/nominatim-service.js.map +1 -0
  49. package/dist/services/nominatim/types.d.ts +55 -0
  50. package/dist/services/nominatim/types.d.ts.map +1 -0
  51. package/dist/services/nominatim/types.js +6 -0
  52. package/dist/services/nominatim/types.js.map +1 -0
  53. package/dist/services/overpass/overpass-service.d.ts +25 -0
  54. package/dist/services/overpass/overpass-service.d.ts.map +1 -0
  55. package/dist/services/overpass/overpass-service.js +146 -0
  56. package/dist/services/overpass/overpass-service.js.map +1 -0
  57. package/dist/services/overpass/types.d.ts +59 -0
  58. package/dist/services/overpass/types.d.ts.map +1 -0
  59. package/dist/services/overpass/types.js +6 -0
  60. package/dist/services/overpass/types.js.map +1 -0
  61. package/package.json +91 -0
  62. package/server.json +153 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overpass-service.js","sourceRoot":"","sources":["../../../src/services/overpass/overpass-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * @fileoverview Types for the Overpass API responses and domain models.
3
+ * @module services/overpass/types
4
+ */
5
+ /** A single element from an Overpass query response. */
6
+ export type OverpassElement = {
7
+ type: 'node' | 'way' | 'relation';
8
+ id: number;
9
+ lat?: number;
10
+ lon?: number;
11
+ center?: {
12
+ lat: number;
13
+ lon: number;
14
+ };
15
+ tags?: Record<string, string>;
16
+ nodes?: number[];
17
+ members?: unknown[];
18
+ };
19
+ /** Parsed Overpass API response. */
20
+ export type OverpassResponse = {
21
+ version: number;
22
+ osm3s?: {
23
+ timestamp_osm_base?: string;
24
+ timestamp_areas_base?: string;
25
+ copyright?: string;
26
+ };
27
+ elements: OverpassElement[];
28
+ };
29
+ /** A normalized POI element for convenience tool output. */
30
+ export type OverpassPoi = {
31
+ osm_type: 'node' | 'way' | 'relation';
32
+ osm_id: number;
33
+ lat?: number;
34
+ lon?: number;
35
+ name?: string;
36
+ tags: Record<string, string>;
37
+ };
38
+ /** Parameters for the around-radius query builder. */
39
+ export type OverpassAroundParams = {
40
+ lat: number;
41
+ lon: number;
42
+ radiusMeters: number;
43
+ tagKey: string;
44
+ tagValue: string;
45
+ elementTypes: ('node' | 'way' | 'relation')[];
46
+ timeoutSeconds: number;
47
+ };
48
+ /** Parameters for the bounding box query builder. */
49
+ export type OverpassBboxParams = {
50
+ south: number;
51
+ west: number;
52
+ north: number;
53
+ east: number;
54
+ tagKey: string;
55
+ tagValue: string;
56
+ elementTypes: ('node' | 'way' | 'relation')[];
57
+ timeoutSeconds: number;
58
+ };
59
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/overpass/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,CAAC,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IAC9C,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,CAAC,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC;IAC9C,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Types for the Overpass API responses and domain models.
3
+ * @module services/overpass/types
4
+ */
5
+ export {};
6
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/overpass/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}
package/package.json ADDED
@@ -0,0 +1,91 @@
1
+ {
2
+ "name": "@cyanheads/openstreetmap-mcp-server",
3
+ "version": "0.2.0",
4
+ "mcpName": "io.github.cyanheads/openstreetmap-mcp-server",
5
+ "description": "Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data via MCP. STDIO or Streamable HTTP.",
6
+ "type": "module",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "bin": {
10
+ "openstreetmap-mcp-server": "dist/index.js"
11
+ },
12
+ "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
13
+ "scripts": {
14
+ "build": "bun run scripts/build.ts",
15
+ "rebuild": "bun run scripts/clean.ts && bun run build",
16
+ "clean": "bun run scripts/clean.ts",
17
+ "devcheck": "bun run scripts/devcheck.ts",
18
+ "tree": "bun run scripts/tree.ts",
19
+ "format": "biome check --write --unsafe",
20
+ "test": "bunx vitest run",
21
+ "audit:refresh": "rm -f bun.lock && bun install && bun audit",
22
+ "list-skills": "bun run scripts/list-skills.ts",
23
+ "lint:mcp": "bun run scripts/lint-mcp.ts",
24
+ "lint:packaging": "bun run scripts/lint-packaging.ts",
25
+ "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/openstreetmap-mcp-server.mcpb",
26
+ "changelog:build": "bun run scripts/build-changelog.ts",
27
+ "changelog:check": "bun run scripts/build-changelog.ts --check",
28
+ "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
29
+ "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
30
+ "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
31
+ },
32
+ "keywords": [
33
+ "mcp",
34
+ "mcp-server",
35
+ "model-context-protocol",
36
+ "typescript",
37
+ "bun",
38
+ "ai-agent",
39
+ "openstreetmap",
40
+ "osm",
41
+ "geocoding",
42
+ "reverse-geocoding",
43
+ "nominatim",
44
+ "overpass",
45
+ "spatial",
46
+ "geolocation"
47
+ ],
48
+ "repository": {
49
+ "type": "git",
50
+ "url": "git+https://github.com/cyanheads/openstreetmap-mcp-server.git"
51
+ },
52
+ "bugs": {
53
+ "url": "https://github.com/cyanheads/openstreetmap-mcp-server/issues"
54
+ },
55
+ "homepage": "https://github.com/cyanheads/openstreetmap-mcp-server#readme",
56
+ "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/openstreetmap-mcp-server#readme)",
57
+ "funding": [
58
+ {
59
+ "type": "github",
60
+ "url": "https://github.com/sponsors/cyanheads"
61
+ },
62
+ {
63
+ "type": "buy_me_a_coffee",
64
+ "url": "https://www.buymeacoffee.com/cyanheads"
65
+ }
66
+ ],
67
+ "license": "Apache-2.0",
68
+ "packageManager": "bun@1.3.0",
69
+ "engines": {
70
+ "bun": ">=1.3.0",
71
+ "node": ">=24.0.0"
72
+ },
73
+ "publishConfig": {
74
+ "access": "public"
75
+ },
76
+ "dependencies": {
77
+ "@cyanheads/mcp-ts-core": "^0.9.9",
78
+ "pino-pretty": "^13.1.3",
79
+ "zod": "^4.4.3"
80
+ },
81
+ "devDependencies": {
82
+ "@biomejs/biome": "^2.4.15",
83
+ "@types/node": "^25.9.1",
84
+ "depcheck": "^1.4.7",
85
+ "ignore": "^7.0.5",
86
+ "tsc-alias": "^1.8.17",
87
+ "tsx": "^4.22.3",
88
+ "typescript": "^6.0.3",
89
+ "vitest": "^4.1.7"
90
+ }
91
+ }
package/server.json ADDED
@@ -0,0 +1,153 @@
1
+ {
2
+ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
+ "name": "io.github.cyanheads/openstreetmap-mcp-server",
4
+ "description": "Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.",
5
+ "repository": {
6
+ "url": "https://github.com/cyanheads/openstreetmap-mcp-server",
7
+ "source": "github"
8
+ },
9
+ "remotes": [
10
+ {
11
+ "type": "streamable-http",
12
+ "url": "https://openstreetmap.caseyjhand.com/mcp"
13
+ }
14
+ ],
15
+ "version": "0.2.0",
16
+ "packages": [
17
+ {
18
+ "registryType": "npm",
19
+ "registryBaseUrl": "https://registry.npmjs.org",
20
+ "identifier": "@cyanheads/openstreetmap-mcp-server",
21
+ "runtimeHint": "bun",
22
+ "version": "0.2.0",
23
+ "packageArguments": [
24
+ {
25
+ "type": "positional",
26
+ "value": "run"
27
+ },
28
+ {
29
+ "type": "positional",
30
+ "value": "start:stdio"
31
+ }
32
+ ],
33
+ "environmentVariables": [
34
+ {
35
+ "name": "OSM_NOMINATIM_BASE_URL",
36
+ "description": "Nominatim API base URL. Override to use a private or mirror instance.",
37
+ "format": "string",
38
+ "isRequired": false,
39
+ "default": "https://nominatim.openstreetmap.org"
40
+ },
41
+ {
42
+ "name": "OSM_USER_AGENT",
43
+ "description": "User-Agent sent to Nominatim and Overpass. Required by usage policy.",
44
+ "format": "string",
45
+ "isRequired": false,
46
+ "default": "openstreetmap-mcp-server/0.2.0"
47
+ },
48
+ {
49
+ "name": "OSM_OVERPASS_BASE_URL",
50
+ "description": "Overpass API endpoint URL. Override to use a mirror or private instance.",
51
+ "format": "string",
52
+ "isRequired": false,
53
+ "default": "https://overpass-api.de/api/interpreter"
54
+ },
55
+ {
56
+ "name": "MCP_LOG_LEVEL",
57
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
58
+ "format": "string",
59
+ "isRequired": false,
60
+ "default": "info"
61
+ }
62
+ ],
63
+ "transport": {
64
+ "type": "stdio"
65
+ }
66
+ },
67
+ {
68
+ "registryType": "npm",
69
+ "registryBaseUrl": "https://registry.npmjs.org",
70
+ "identifier": "@cyanheads/openstreetmap-mcp-server",
71
+ "runtimeHint": "bun",
72
+ "version": "0.2.0",
73
+ "packageArguments": [
74
+ {
75
+ "type": "positional",
76
+ "value": "run"
77
+ },
78
+ {
79
+ "type": "positional",
80
+ "value": "start:http"
81
+ }
82
+ ],
83
+ "environmentVariables": [
84
+ {
85
+ "name": "MCP_HTTP_HOST",
86
+ "description": "The hostname for the HTTP server.",
87
+ "format": "string",
88
+ "isRequired": false,
89
+ "default": "127.0.0.1"
90
+ },
91
+ {
92
+ "name": "MCP_HTTP_PORT",
93
+ "description": "The port to run the HTTP server on.",
94
+ "format": "string",
95
+ "isRequired": false,
96
+ "default": "3010"
97
+ },
98
+ {
99
+ "name": "MCP_HTTP_ENDPOINT_PATH",
100
+ "description": "The endpoint path for the MCP server.",
101
+ "format": "string",
102
+ "isRequired": false,
103
+ "default": "/mcp"
104
+ },
105
+ {
106
+ "name": "MCP_PUBLIC_URL",
107
+ "description": "Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).",
108
+ "format": "string",
109
+ "isRequired": false
110
+ },
111
+ {
112
+ "name": "MCP_AUTH_MODE",
113
+ "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
114
+ "format": "string",
115
+ "isRequired": false,
116
+ "default": "none"
117
+ },
118
+ {
119
+ "name": "OSM_NOMINATIM_BASE_URL",
120
+ "description": "Nominatim API base URL. Override to use a private or mirror instance.",
121
+ "format": "string",
122
+ "isRequired": false,
123
+ "default": "https://nominatim.openstreetmap.org"
124
+ },
125
+ {
126
+ "name": "OSM_USER_AGENT",
127
+ "description": "User-Agent sent to Nominatim and Overpass. Required by usage policy.",
128
+ "format": "string",
129
+ "isRequired": false,
130
+ "default": "openstreetmap-mcp-server/0.2.0"
131
+ },
132
+ {
133
+ "name": "OSM_OVERPASS_BASE_URL",
134
+ "description": "Overpass API endpoint URL. Override to use a mirror or private instance.",
135
+ "format": "string",
136
+ "isRequired": false,
137
+ "default": "https://overpass-api.de/api/interpreter"
138
+ },
139
+ {
140
+ "name": "MCP_LOG_LEVEL",
141
+ "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
142
+ "format": "string",
143
+ "isRequired": false,
144
+ "default": "info"
145
+ }
146
+ ],
147
+ "transport": {
148
+ "type": "streamable-http",
149
+ "url": "http://localhost:3010/mcp"
150
+ }
151
+ }
152
+ ]
153
+ }