Geocoding Tool

A Model Context Protocol (MCP) server that provides latitude/longitude coordinates for cities and locations using the OpenStreetMap Nominatim API.

- 🌍Global Geocoding: Get coordinates for any location worldwide
- 🆓Free API: Uses OpenStreetMap Nominatim (no API key required)
- �MCP Integration: Works with Cursor, VS Code, Claude Desktop, and other MCP-compatible tools
- 📦Easy Installation: Install via PyPI withuvx geocode-mcp
- �️Modern Tooling: Built with Python 3.12+, async/await, and comprehensive testing

Install the package from PyPI using uvx (recommended):

{ "mcpServers": { "geocoding": { "command": "uvx", "args": ["geocode-mcp"] } } }

See theconfig/directory for specific examples for different tools.

Get coordinates for Tokyo, Japan Find the latitude and longitude of London, UK What are the coordinates for New York City? Get coordinates for "1600 Pennsylvania Avenue, Washington DC" with limit 5

{ "query": "Tokyo, Japan", "results_count": 1, "coordinates": [ { "latitude": 35.6762, "longitude": 139.6503, "display_name": "Tokyo, Japan", "place_id": "282885117", "type": "city", "class": "place", "importance": 0.9, "bounding_box": { "south": 35.619, "north": 35.739, "west": 139.619, "east": 139.682 } } ] }

Copy the configuration fromconfig/cursor-mcp.jsonto your Cursor MCP settings.

Copy the configuration fromconfig/vscode-mcp.jsonto your VS Code MCP settings.

Copy the configuration fromconfig/claude-desktop.jsonto your Claude Desktop config file.

See theconfig READMEfor detailed setup instructions.

# Clone the repository git clone https://github.com/X-McKay/geocode-mcp.git cd geocode-mcp # Install with development dependencies pip install -e ".[dev]"

# Run all tests pytest # Run with coverage pytest --cov=src/geocode_mcp --cov-report=html # Run specific test files pytest tests/test_geocoding.py -v pytest tests/test_mcp_server.py -v

# Format code ruff format # Lint code ruff check # Run all checks ruff check && ruff format --check

For local development and testing, you can run the server directly:

Or use the development configuration in your MCP client:

{ "mcpServers": { "geocoding": { "command": "python", "args": ["-m", "geocode_mcp.server"], "cwd": "/path/to/geocode-mcp", "env": { "PYTHONPATH": "/path/to/geocode-mcp/src" } } } }

geocode-mcp/ ├── src/geocode_mcp/ # Main source code │ └── server.py # MCP server implementation ├── tests/ # Test suite │ ├── test_geocoding.py # Geocoding functionality tests │ ├── test_mcp_server.py # MCP server integration tests │ ├── test_mcp.py # MCP protocol tests │ └── test_vscode.py # VS Code integration tests ├── config/ # Configuration examples │ ├── cursor-mcp.json # Cursor configuration │ ├── vscode-mcp.json # VS Code configuration │ ├── claude-desktop.json # Claude Desktop configuration │ └── README.md # Configuration guide ├── docs/ # Documentation ├── pyproject.toml # Project configuration ├── requirements.txt # Production dependencies ├── requirements-dev.txt # Development dependencies └── README.md # This file

async def geocode_location(location: str, limit: int = 1) -> dict[str, Any]: """ Geocode a location using OpenStreetMap Nominatim API. Args: location: The location to geocode limit: Maximum number of results (1-10) Returns: Dictionary containing query, results_count, and coordinates """

The server implements the Model Context Protocol and provides themcp_geocoding_get_coordinatestool for use in MCP-compatible applications.
- Fork the repository
- Create a feature branch (git checkout -b feature/amazing-feature)
- Make your changes
- Run tests (pytest)
- Run linting (ruff check && ruff format)
- Commit your changes (git commit -m 'Add amazing feature')
- Push to the branch (git push origin feature/amazing-feature)
- Open a Pull Request

This project is licensed under the MIT License - see theLICENSEfile for details.

- OpenStreetMapfor providing the free Nominatim geocoding service
- Model Context Protocolfor the protocol specification
- The Python MCP SDK team for the excellent tooling make lint

### Testing 

SeeCursor Integration Guidefor detailed setup instructions.

The server provides theget_coordinatestool that can be called via the MCP protocol.

- Fork the repository

- Create a feature branch

- Make your changes

- Run tests:make test

- Run linting:make lint

- Submit a pull request

This project is licensed under the MIT License - see theLICENSEfile for details.

- OpenStreetMapfor providing the Nominatim geocoding service

- MCPfor the protocol specification

-

Copy Files:Copy each file section above into files with the respective names
Configure MCP Client:Add to your MCP client (like Claude Desktop) configuration:

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Fetch, convert, and search AWS documentation pages, with recommendations for related content.

Search campgrounds around the world on campertunity, check availability, and provide booking links.

The Ferryhopper MCP Server exposes ferry routes, schedules and booking redirects so an AI assistant can discover connections across Europe and the Mediterranean and send users to Ferryhopper to complete bookings.

All-in-One SEO & Web Intelligence Toolkit API from FetchSERP.

MCP server that provides read-only access to HyperKitty, the web-based email archive component of Mailman 3.

At Sunrise Apps, we believe AI agents should be limitless, especially when it comes to visual data. We created ImageSorcery to bridge the critical gap in AI's ability to interact with and manipulate images directly, all while upholding the highest standards of privacy and security.

Just Domain is the domain registrar for businesses built with AI. Its remote MCP server checks availability and returns first-year and renewal pricing, plus a link to register on justdomain.ai, with DNS and WHOIS privacy in the same place. No account, no API key, read only. Endpoint: https://mcp.justdomain.ai/

Research tools, including a Sqlite-backed document stash

Semantic search over 9 free-license stock photo sources. Hosted remote server with OAuth — no API key to paste.

SerpApi MCP Server for Google and other search engine results