EPSG

You can run and use the EPSG MCP Server to access knowledge about coordinate reference systems, including Japan’s JGD2011 and Japan Plane Rectangular Coordinate Systems, along with global CRS. This server focuses on knowledge provision, recommendations, and decision support, while delegating actual coordinate transformation to its companion components.

How to use

You interact with the EPSG MCP Server through an MCP client. Start the server using the recommended runtime, then configure your client to point to the MCP, enable optional country packs or language settings, and optionally supply a local EPSG database path for extended coverage. You can search, retrieve details, compare, recommend, validate, transform paths, and troubleshoot CRS choices for your location and purpose.

How to install

Prerequisites: ensure you have Node.js installed on your system. You can download Node.js from the official site and verify with node -v and npm -v.

Install the EPSG MCP Server package locally in your project.

npm install @shuji-bonji/epsg-mcp

Alternatively, you can run the MCP server directly without installing a local package.

npx @shuji-bonji/epsg-mcp

Configure the MCP client to use EPSG MCP Server

To connect a Claude Desktop MCP client to the EPSG MCP Server, add the following configuration snippet under mcpServers for your client. This config uses a local, stdio-based approach via npm and npx.

{
  "mcpServers": {
    "epsg": {
      "command": "npx",
      "args": ["@shuji-bonji/epsg-mcp"]
    }
  }
}

Additional environment and options

You can enable additional country packs, language preferences, and a local EPSG database path to extend coverage and tailor responses.

{
  "mcpServers": {
    "epsg": {
      "command": "npx",
      "args": ["@shuji-bonji/epsg-mcp"],
      "env": {
        "EPSG_PACKS": "jp,us,uk",
        "EPSG_LANG": "ja",
        "EPSG_DB_PATH": "/path/to/epsg.db"
      }
    }
  }
}

Notes on usage

The server provides CRS search, detailed CRS information, region-specific listings, recommendations, validation, transformation path suggestions, CRS comparisons, best practices, and troubleshooting guidance. You can tune packs and language settings to fit your region and preferred language.

Security and data handling

Maintain secure access to your MCP client configuration. When using a local database for EPSG data, ensure the database file is stored securely and is not exposed publicly. Follow your organization’s security practices for environment variables and data handling.

Examples of common workflows

• Search for a CRS related to JGD2011 and review its area of use, projection, and accuracy.

• Get CRS details for EPSG:3857 and compare with a geographic CRS like EPSG:4326 from datum and distortion perspectives.

• Request a CRS recommendation for web mapping around Tokyo, Japan, with a focus on minimizing distortion in web display.

Available tools

search_crs

Search CRS by keywords such as EPSG code, name, region, or prefecture to quickly find relevant coordinate systems.

get_crs_detail

Retrieve detailed information for a specific CRS by its code, including datum, projection, and area of use.

list_crs_by_region

Get available CRS and recommendations by region, with optional filters by type and deprecation status.

recommend_crs

Provide a recommended CRS based on purpose and location, with alternatives and reasoning.

validate_crs_usage

Check if a chosen CRS is appropriate for a given purpose and location, returning issues and improvement suggestions.

suggest_transformation

Propose optimal transformation paths between two CRS, including direct and via paths and warnings.

compare_crs

Compare two CRS across multiple aspects such as datum, projection, accuracy, and compatibility.

get_best_practices

Offer best practices for CRS usage across topics like surveying, web mapping, and data exchange.

troubleshoot

Diagnose CRS-related problems by symptoms, provide causes, steps, and solutions.