mcpField
M
mcp-server-geodata-placefinder

mcp-server-geodata-placefinder

Local
github.com/fouomeneMaps & Travel1Updated 22w ago
Repository

About mcp-server-geodata-placefinder

mcp-server-geodata-placefinder gives MCP clients access to GeoData Placefinder geocoding, Overture Maps data, and DuckDB. It is for assistants that need to search places, resolve coordinates to addresses, or retrieve nearby and detailed place information.

Key features

  1. 01Search places by name, address, or category
  2. 02Reverse geocode coordinates
  3. 03Find the nearest place within a radius
  4. 04Retrieve an Overture Maps place record by ID
  5. 05Check API status, version, and cache size

Use cases

  1. 01Find businesses or places from a natural-language query
  2. 02Identify the nearest place to given coordinates
  3. 03Look up a place's full record by its ID

MCP support

Exposes place search, reverse geocoding, nearest-place lookup, place-by-ID retrieval, and health-check tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "fouomene-mcp-server-geodata-placefinder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-geodata-placefinder"
      ]
    }
  }
}
Run commandnpx -y mcp-server-geodata-placefinder

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-server-geodata-placefinder2.0.0

Tools

5

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

mcp-server-geodata-placefinder

An MCP (Model Context Protocol) server that gives AI assistants (Claude, Cursor, Zed, etc.) direct access to the GeoData Placefinder geocoding API, Overture Maps data and DuckDB. Official MCP Registry

Tools

ToolDescription
health_checkCheck API status, version, and cache size
search_placesGeocode by name, address, city, postcode, or category
reverse_geocodeConvert coordinates → nearest place names and addresses
find_nearest_placeSingle closest place within a configurable radius
get_place_by_idFull Overture Maps record for a place by ID

Quick start

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "geodata-placefinder": {
      "command": "npx",
      "args": ["-y", "mcp-server-geodata-placefinder"]
    }
  }
}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "geodata-placefinder": {
      "command": "npx",
      "args": ["-y", "mcp-server-geodata-placefinder"]
    }
  }
}
Other MCP clients

Any MCP-compatible client can run the server via:

npx mcp-server-geodata-placefinder

Example queries

Once connected, you can ask your AI assistant:

  • "Find coffee shops near the Eiffel Tower"
  • "What's at coordinates 48.8584, 2.2945?"
  • "Find the nearest hospital to 40.7128, -74.0060 within 2km"
  • "Get full details for overture:place:ac0aed88-e6cb-4224-9520-441339447760"

Development

# Clone the repository
git clone https://github.com/fouomene/geodataplacefinder.git
cd geodataplacefinder/mcp-server

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build
pnpm build

# Type-check
pnpm typecheck

License

GPL-3.0 — see LICENSE.

Links

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.