MCP.so
Sign In

Epsg Mcp Server

@shuji-bonji

About Epsg Mcp Server

An MCP server that provides knowledge about Coordinate Reference Systems (CRS).

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

9

Search EPSG Coordinate Reference Systems (CRS) by keyword. Searchable by EPSG code, name, region name, or prefecture name. Covers Japanese JGD2011 CRS family, global WGS84, Web Mercator, and more.

Get detailed information for a specific EPSG code. Includes datum, projection method, area of use, accuracy characteristics, and intended use cases.

Get available CRS list for a region with purpose-based recommendations. Japan includes Plane Rectangular CS (Zones I-XIX), Global includes WGS84 and UTM zones.

Recommend the optimal CRS based on purpose and location. Supports web mapping, distance/area calculation, surveying, navigation, data exchange, etc. Full support for Japan Plane Rectangular CS (Zones I-XIX) including multi-zone regions like Hokkaido and Okinawa.

Validate whether a CRS is appropriate for a specific purpose and location. Detects deprecated CRS usage, area/distance calculation distortion issues, inappropriate zone selection for surveying, and provides improvement suggestions.

Suggest transformation paths between two CRS. Covers Tokyo Datum to JGD2011, WGS84 to Plane Rectangular CS, etc. Searches multi-step paths, provides accuracy info, and warns about cumulative errors.

Compare two CRS from various perspectives. Compares datum, projection method, area of use, accuracy, distortion characteristics, compatibility, and use case suitability. Explains which is better suited for specific purposes.

Get CRS best practices for specific topics. Covers surveying in Japan, web mapping, data exchange, coordinate storage, mobile GPS, cross-border data, historical data, GIS integration, precision requirements, and projection selection. Provides recommended practices, common mistakes, and reference materials.

Troubleshoot CRS-related problems. Diagnoses coordinate shifts (cm, m, km scale), area/distance calculation errors, data not displaying, and transformation errors. Identifies causes, provides diagnostic steps, and solutions.

Overview

What is Epsg Mcp Server?

An MCP server that provides specialized knowledge and decision support for Coordinate Reference Systems (CRS) worldwide. It uses a 3-layer fallback: country packs, automatic UTM zone calculation, and safe defaults. Coordinate transformation execution is delegated to another server, so this server focuses on knowledge provision and decision support.

How to use Epsg Mcp Server?

Install via npm: npm install @shuji-bonji/epsg-mcp. Run directly: npx @shuji-bonji/epsg-mcp. Configure in Claude Desktop by adding to claude_desktop_config.json with command npx and args ["@shuji-bonji/epsg-mcp"]. Optionally set environment variables EPSG_PACKS and EPSG_LANG for country packs and language.

Key features of Epsg Mcp Server

  • CRS search by keyword, code, name, region.
  • Detailed CRS information including datum, projection, area of use.
  • Regional CRS listings with purpose-specific recommendations.
  • Optimal CRS recommendation based on purpose and location.
  • Usage validation to verify CRS selection appropriateness.
  • Transformation routing using BFS graph search.
  • CRS comparison from 7 perspectives.
  • Best practices guidance on 10 topics.
  • Troubleshooting diagnosis by symptom.
  • Country pack system for extensible regional expertise.
  • Offline operation with local database.

Use cases of Epsg Mcp Server

  • Search for a CRS by EPSG code or name.
  • Get optimal CRS recommendation for a specific location and purpose, e.g., surveying in Tokyo.
  • Validate whether a chosen CRS is appropriate for a given task and region.
  • Find transformation paths between two CRS, e.g., from Tokyo Datum to JGD2011.
  • Troubleshoot coordinate shift problems by describing symptoms.

FAQ from Epsg Mcp Server

What data does Epsg Mcp Server use?

The server uses a local database, enabling offline operation with no external API needed.

What country packs are available and how to enable them?

Available packs: jp (Japan), us (United States), uk/gb (United Kingdom). By default only Japan is loaded. Set the EPSG_PACKS environment variable to a comma-separated list (e.g., "jp,us,uk") to enable additional packs.

Does Epsg Mcp Server perform coordinate transformations?

No, coordinate transformation execution is delegated to mcp-server-proj. This server focuses on knowledge provision, decision support, and transformation routing.

What are the runtime requirements?

Node.js 18 or higher is required.

How do I get output in Japanese?

Set the EPSG_LANG environment variable to "ja" for Japanese output; English is the default.

Frequently asked questions

What data does Epsg Mcp Server use?

The server uses a local database, enabling offline operation with no external API needed.

What country packs are available and how to enable them?

Available packs: jp (Japan), us (United States), uk/gb (United Kingdom). By default only Japan is loaded. Set the `EPSG_PACKS` environment variable to a comma-separated list (e.g., "jp,us,uk") to enable additional packs.

Does Epsg Mcp Server perform coordinate transformations?

No, coordinate transformation execution is delegated to mcp-server-proj. This server focuses on knowledge provision, decision support, and transformation routing.

What are the runtime requirements?

Node.js 18 or higher is required.

How do I get output in Japanese?

Set the `EPSG_LANG` environment variable to "ja" for Japanese output; English is the default.

Comments

More Other MCP servers