Yandex Maps MCP Server

Name: Yandex Maps MCP Server
Author: peschinskiy

@peschinskiy

代码仓库

关于 Yandex Maps MCP Server

MCP server for Yandex Maps map rendering and geocoding APIs

#maps #mcp #yandex-maps #static-maps

基本信息

分类

媒体与设计

许可证

MIT

运行时

node

传输方式

stdio

发布者

peschinskiy

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "yandex-maps-mcp": {
      "command": "node",
      "args": [
        "dist/index.js"
      ]
    }
  }
}

工具

`country` (string) - The country name

location, formatted_address, address_components

`latitude` (number)

location, formatted_address, address_components

`latitude` (number) - Latitude coordinate of map center

PNG image of the map

概览

What is Yandex Maps MCP Server?

A Model Context Protocol server that integrates with the Yandex Maps API, allowing AI assistants (like Claude) to geocode addresses, reverse geocode coordinates, and render static map images. It is aimed at developers building location-aware workflows with LLMs via MCP.

How to use Yandex Maps MCP Server?

Obtain Yandex JavaScript/Geocoder and Static API keys from the Yandex Developer portal. Install dependencies (npm install), build (npm run build), and set the YANDEX_MAPS_API_KEY and YANDEX_MAPS_STATIC_API_KEY environment variables. Run locally via node dist/index.js or add to Claude Desktop’s claude_desktop_config.json for stdio. For remote access, set MCP_TRANSPORT=http and optionally MCP_PORT and MCP_AUTH_TOKEN.

Key features of Yandex Maps MCP Server

Convert an address to geographic coordinates (maps_geocode)
Convert coordinates to a readable address (maps_reverse_geocode)
Render a map as a PNG image (maps_render)
Display optional placemarks on rendered maps
Supports both stdio and HTTP transport modes
Stateless HTTP server with optional Bearer token authentication

Use cases of Yandex Maps MCP Server

Geocode a known address to obtain latitude/longitude for further analysis
Convert GPS coordinates into a human-readable location description
Generate a static map image centered on a location with custom placemarks
Automate geocoding tasks in a workflow via the HTTP server (e.g., in n8n)
Combine with web search or user input to geocode addresses discovered by the model

FAQ from Yandex Maps MCP Server

What API keys are required?

Two Yandex API keys are needed: one for “JavaScript and Geocoder API” (used by geocoding tools) and one for Static API (used for map rendering).

What transport modes does the server support?

It supports stdio transport for local desktop use and Streamable HTTP transport for remote access and web-based clients like n8n.

Does the HTTP server support authentication?

Yes. Setting the MCP_AUTH_TOKEN environment variable enables Bearer token authentication. If not set, the server runs without authentication (not recommended for production).

What are the known limitations of this server?

The Yandex Maps Places API has no free tier, so the server cannot retrieve organization addresses or coordinates. It can only geocode places whose addresses or coordinates are already known to the model (e.g., from user input or web search).

Is the HTTP server stateful?

No, the HTTP server is explicitly stateless.

媒体与设计分类下的更多 MCP 服务器

Photoshop MCP Server

loonghao

A Model Context Protocol (MCP) server that interfaces with Adobe Photoshop's Python API. Enables LLMs to execute image editing operations, automate workflows, and manage Photoshop tasks through structured commands and context-aware interactions.

275

MiniMax MCP

MiniMax-AI

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

1.5K