Skip to content
This repository was archived by the owner on Apr 14, 2026. It is now read-only.

INSTALLATION.md

Latest commit

 

History

History
134 lines (101 loc) · 3.63 KB

INSTALLATION.md

File metadata and controls

134 lines (101 loc) · 3.63 KB

Geocoding MCP Desktop Extension - Installation Guide

Overview

This guide will help you install and configure the Geocoding MCP Desktop Extension (MCPB) for Claude Desktop.

Prerequisites

  • Claude Desktop application installed
  • macOS, Windows, or Linux operating system
  • Internet connection for geocoding API calls

Installation Steps

Method 1: Manual Installation (Recommended)

  1. Locate the MCPB file

    • Find the mcp.mcpb file in your project directory
    • File size: ~44MB

  2. Install via Claude Desktop

    • Open Claude Desktop
    • Go to Settings → Extensions
    • Click "Install Extension"
    • Select the mcp.mcpb file
    • Follow the installation prompts

  3. Verify Installation

    • Restart Claude Desktop
    • Check that "Geocoding MCP" appears in your extensions list
    • The extension should show as "Active"

Method 2: Command Line Installation (Advanced)

# If you have the MCPB CLI installed
mcpb install mcp.mcpb

# Or using bunx
bunx @anthropic-ai/mcpb install mcp.mcpb

Configuration

No additional configuration is required. The extension uses the free Nominatim API service.

Usage

Once installed, you can use the following tools in Claude Desktop:

Geocode Tool

Convert addresses to coordinates:

Find the coordinates for "Times Square, New York"

Reverse Geocode Tool

Convert coordinates to addresses:

What address is at coordinates 40.7580, -73.9855?

Available Parameters

Geocode Parameters

  • query (required): Address or place name to search
  • format: Output format (json, xml, geojson, etc.)
  • addressdetails: Include detailed address components (0 or 1)
  • countrycodes: Limit search to specific countries
  • limit: Maximum number of results
  • extratags: Include additional tags
  • namedetails: Include name details
  • polygon_*: Include geometry data

Reverse Geocode Parameters

  • lat (required): Latitude (-90 to 90)
  • lon (required): Longitude (-180 to 180)
  • zoom: Detail level (0-18, higher = more detailed)
  • format: Output format
  • addressdetails: Include detailed address components
  • extratags: Include additional tags
  • namedetails: Include name details

Troubleshooting

Extension Not Loading

  1. Check that the DXT file is not corrupted
  2. Restart Claude Desktop
  3. Verify system compatibility
  4. Check Claude Desktop logs for errors

API Errors

  1. Verify internet connection
  2. Check if Nominatim service is accessible
  3. Ensure query parameters are valid
  4. Try simpler queries if complex ones fail

Performance Issues

  1. Reduce the number of results requested
  2. Avoid requesting polygon data unless needed
  3. Use appropriate zoom levels for reverse geocoding

Data Source & License

  • Data Source: OpenStreetMap via Nominatim API
  • License: Data © OpenStreetMap contributors, ODbL 1.0
  • Usage Policy: Please respect Nominatim's usage policy
  • Rate Limits: Be mindful of API rate limits for heavy usage

Support

For issues or questions:

  1. Check the troubleshooting section above
  2. Review the DXT_README.md for detailed documentation
  3. Verify your query format and parameters
  4. Check Claude Desktop extension logs

Uninstallation

To remove the extension:

  1. Open Claude Desktop Settings
  2. Go to Extensions
  3. Find "Geocoding MCP" in the list
  4. Click "Uninstall" or "Remove"
  5. Restart Claude Desktop

Version Information

  • Extension Version: 1.x
  • MCPB Version: 0.2
  • MCP SDK Version: Latest
  • Node.js Compatibility: 18.x and above

Note: This extension runs locally and does not store or transmit personal data beyond the geocoding queries sent to the Nominatim API.