MCP server MapIron
Commit 9 de nov. de 2026Fornece geocodificação, imagens de mapas estáticos e mapas de área com privacidade usando dados do OpenStreetMap.
Também conhecido como Software-Consulting/mapiron-mcp, maps
- Stars
- 0
- Ferramentas
- 5
- Downloads, 30 dias
- —
- Versão mais recente
- 1.0.3
- Último commit
- 9 de nov. de 2026
- Licença
- MIT
O que é o MCP MapIron?
MapIron é um MCP server. Fornece geocodificação, imagens de mapas estáticos e mapas de área com privacidade usando dados do OpenStreetMap. Ele expõe 5 ferramentas, como geocode, reverse_geocode, static_map.
Resumo gerado a partir do README do projeto
Sobre o MCP server de MapIron
O MapIron oferece aos desenvolvedores acesso aos dados do OpenStreetMap por meio de um conjunto de ferramentas de mapeamento. Ele permite a geocodificação de endereços em coordenadas, a realização de geocodificação reversa e a geração de imagens de mapas estáticos. Uma ferramenta exclusiva, a privacy-area-map, pode exibir regiões sombreadas em vez de pins exatos para proteger locais específicos. Os usuários também podem gerar código e URLs para mapas interativos usando MapLibre GL JS, Leaflet ou OpenLayers.
Este MCP server pode ser usado como um serviço HTTP hospedado ou via uma ponte stdio local para clientes como o Claude Desktop. Para usar a versão hospedada, você deve fornecer um header de Authorization com sua API key. Para configurações locais usando npx, você deve configurar a variável de ambiente MAPIRON_API_KEY. O serviço opera em um modelo com um plano gratuito e planos pagos com valores fixos que incluem limites mensais sem cobrança de excedentes.
O que você pode fazer com ele
- 1Converter endereços em coordenadasPeça à IA para encontrar a latitude e a longitude de um endereço específico.
- 2Gerar visualizações de localização com privacidadeSolicite um mapa que mostre uma área geral sem revelar um ponto exato.
- 3Criar imagens de mapas estáticosPeça para a IA renderizar uma imagem de mapa que inclua marcadores específicos ou uma rota de viagem.
- 4Construir mapas web interativosSolicite o código e as URLs necessários para implementar um mapa usando Leaflet ou OpenLayers.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP MapIron
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP MapIron no Claude Code
$ claude mcp add --transport http maps https://api.pinsharing.com/v1/mcpInstalar o MCP MapIron no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"maps": {
"url": "https://api.pinsharing.com/v1/mcp"
}
}
}Instalar o MCP MapIron no VS Code
.vscode/mcp.json
{
"servers": {
"maps": {
"type": "http",
"url": "https://api.pinsharing.com/v1/mcp"
}
}
}Instalar o MCP MapIron no VS Code CLI
$ code --add-mcp '{"name":"maps","type":"http","url":"https://api.pinsharing.com/v1/mcp"}'Instalar o MCP MapIron no Codex
$ codex mcp add maps --url https://api.pinsharing.com/v1/mcpInstalar o MCP MapIron no Codex config.toml
~/.codex/config.toml
[mcp_servers.maps] url = "https://api.pinsharing.com/v1/mcp"
Instalar o MCP MapIron no Gemini CLI
$ gemini mcp add -s user --transport http maps https://api.pinsharing.com/v1/mcpInstalar o MCP MapIron no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"maps": {
"url": "https://api.pinsharing.com/v1/mcp",
"type": "http"
}
}
}Ferramentas do MCP MapIron 5
Detectadas a partir do READMEgeocodereverse_geocodestatic_mapprivacy_area_mapmap_setup
| geocode | — | |
| reverse_geocode | — | |
| static_map | — | |
| privacy_area_map | — | |
| map_setup | — |
Configuração
MAPIRON_API_KEY
| Nome | Descrição | Tipo |
|---|---|---|
| MAPIRON_API_KEY | — |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Ainda não verificado. Um servidor precisa de uma pontuação de 80, nenhum problema grave e dados suficientes para verificarmos. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelsoftware-consulting/mapiron-mcp is public and reachablegithub.com/software-consulting/mapiron-mcp ↗Passou
- O pacote indica este repositório como sua origemNão verificado
- Proveniência da build (atestação Sigstore)Não verificado
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-09github.com/software-consulting/mapiron-mcp ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNão verificado
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNo tool named like delete, drop or execPassou
- O endpoint remoto responde ao handshake do MCPinitialize answered with protocol 2025-06-18 in 258 msPassou
README
Ver no GitHubMapIron MCP
MapIron (https://mapiron.com) is a map API built on OpenStreetMap data, with a free plan and flat paid plans. It provides static map images, including a privacy-area mode, geocoding, and tiles. This repository provides a small stdio-to-HTTP bridge for MCP clients that can only launch local servers.
MCP Registry: com.mapiron/maps
MapIron was called PinSharing until November 2026. Old configs keep working: see Upgrading from PinSharing.
Most clients: use the hosted server directly
The hosted MCP server is available at:
https://api.mapiron.com/v1/mcp
See https://mapiron.com/docs/mcp for setup. With Claude Code:
claude mcp add --transport http mapiron https://api.mapiron.com/v1/mcp --header "Authorization: Bearer YOUR_KEY"
Clients that only run local servers (stdio)
Some clients, such as Claude Desktop with claude_desktop_config.json, can only launch local stdio MCP servers. For those, use this bridge.
{
"mcpServers": {
"mapiron": {
"command": "npx",
"args": ["-y", "github:Software-Consulting/mapiron-mcp"],
"env": { "MAPIRON_API_KEY": "ps_your_key" }
}
}
}
Git and Node.js 18+ are required.
Tools
| Tool | What it does | What it counts |
|---|---|---|
geocode |
Convert addresses or place names to coordinates | 1 geocode |
reverse_geocode |
Convert coordinates to an address or place | 1 geocode |
static_map |
Render a map image with markers or a route | 1 static image |
privacy_area_map |
Show roughly where a place is (a shaded area, no pin); never reveals the exact point | 1 static image |
map_setup |
Code and URLs for an interactive map (MapLibre GL JS, Leaflet, OpenLayers) | free |
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
MAPIRON_API_KEY |
Recommended | none | MapIron API key (ps_...). Without it, discovery works and tool calls return the server's missing_key error. |
MAPIRON_MCP_URL |
No | https://api.mapiron.com/v1/mcp |
Hosted MCP server URL. Must be https: unless the host is localhost or 127.0.0.1. |
MAPIRON_MCP_TIMEOUT_MS |
No | 60000 |
HTTP timeout in milliseconds. |
MAPIRON_MCP_DEBUG |
No | unset | Set to 1 to write debug logs to stderr. |
Upgrading from PinSharing
Nothing breaks if you change nothing:
github:Software-Consulting/pinsharing-mcpredirects to this repository.PINSHARING_API_KEY,PINSHARING_MCP_URL,PINSHARING_MCP_TIMEOUT_MSandPINSHARING_MCP_DEBUGare still read. If both names are set, theMAPIRON_one wins.- Existing
ps_keys work unchanged, andhttps://api.pinsharing.com/v1/mcpstill serves the same tools.
To move to the new names, change the repository in args to github:Software-Consulting/mapiron-mcp and rename the variable to MAPIRON_API_KEY.
How it works
The bridge reads JSON-RPC messages from stdin, one per line, and forwards each one to the hosted MCP server over HTTPS. Responses are written to stdout, one JSON object per line. Nothing is stored locally. The API key is only sent to the configured server (by default api.mapiron.com) in the Authorization header, and never printed in logs or errors.
Plans and caps
MapIron has hard monthly caps and no overage billing. A free plan is available without a card:
- Pricing and caps: https://mapiron.com/pricing
- Free keys / dashboard: https://mapiron.com/dashboard
Attribution
Map data © OpenStreetMap contributors. Show attribution wherever map results or images appear.
Development
npm test
The project has zero runtime or development dependencies.
License
MIT. MapIron is a service of Wells Software Consulting LLC.
Perguntas sobre o MCP MapIron
Como adiciono o MCP MapIron ao Claude Code?
Execute claude mcp add --transport http maps https://api.pinsharing.com/v1/mcp no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP MapIron ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Quais ferramentas o MCP MapIron oferece?
Ele expõe 5 ferramentas, incluindo geocode, reverse_geocode, static_map, privacy_area_map, map_setup.
Como posso usar o MapIron com o Claude Desktop?
Você pode usar a ponte stdio adicionando o servidor ao seu claude_desktop_config.json usando npx e fornecendo sua MAPIRON_API_KEY.
O que é a ferramenta privacy-area map?
A ferramenta privacy_area_map exibe uma área sombreada que representa um local sem revelar o ponto exato ou utilizar um pin.
Posso usar minhas chaves antigas da API PinSharing?
Sim, as chaves ps_ existentes funcionam sem alterações e as variáveis de configuração antigas ainda são suportadas.