Epsg Mcp Server

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.