MCP-Geo

Name: MCP-Geo
Author: webcoderz

@webcoderz

代码仓库

关于 MCP-Geo

Geocoding MCP server with GeoPY!

#geocoding #geopy #mcp-server

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

webcoderz

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "MCP-Geo": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-r",
        "requirements.txt"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MCP-Geo?

MCP-Geo is a geocoding MCP server built with GeoPy. It provides tools that allow Large Language Models (LLMs) to geocode addresses, reverse geocode coordinates, calculate distances, and perform batch lookups in a rate-limited, error-handled way. It is aimed at developers integrating location capabilities into AI workflows via Claude Desktop or other MCP clients.

How to use MCP-Geo?

Clone the repository, install dependencies with uv sync, then install the server using fastmcp install geo.py --name "MCP Geo" for Claude Desktop. For other environments, add the JSON configuration (with command: "uv", args: ["--directory", "MCP-Geo", "run", "geo.py"]) to your MCP settings file, optionally setting environment variables like GEOCODER_PROVIDER, NOMINATIM_URL, or API keys for alternative providers.

Key features of MCP-Geo

Geocode a single address to latitude, longitude, and formatted address.
Reverse geocode a latitude/longitude pair to the nearest address.
Geocode with additional details like bounding boxes (provider-dependent).
Batch geocode multiple addresses with rate limiting.
Batch reverse geocode multiple coordinate pairs.
Calculate distance between two addresses or coordinate pairs in miles/kilometers.

Use cases of MCP-Geo

Convert a user‑provided place name into map coordinates for display or analysis.
Find the street address corresponding to a GPS coordinate from a photo or sensor.
Enrich location data by geocoding a list of addresses in one request.
Calculate the distance between two addresses (e.g., for logistics or travel planning).

FAQ from MCP-Geo

What are the system requirements?

Python 3.6 or higher is required.

What dependencies are needed?

The server requires fastmcp (for the MCP framework) and geoPy (for geocoding). All dependencies are listed in requirements.txt and can be installed via uv sync.

How do I install MCP-Geo for Claude Desktop?

Run fastmcp install geo.py --name "MCP Geo" after cloning the repository and installing dependencies.

How can I switch the geocoding provider?

Set the GEOCODER_PROVIDER environment variable to "nominatim", "arcgis", or "bing". Additional variables (e.g., ARC_USERNAME, ARC_PASSWORD, BING_API_KEY, NOMINATIM_URL, SCHEME) can be configured in the MCP settings file or shell environment.

What safety features does MCP-Geo include?

Rate limiting (default 1‑second delay per geocoding call) prevents hitting service quotas, and error handling catches geopy exceptions, returning None instead of crashing.

其他分类下的更多 MCP 服务器

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K