Epsg MCP Server

@shuji-bonji

Repository Homepage

Basic information

About Epsg MCP Server

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

#gis#epsg

Epsg MCP Server config

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

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

Epsg MCP Server tools

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.

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

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K