MapIron Maps (formerly PinSharing)

MapIron MCP

MapIron（https://mapiron.com）は、OpenStreetMap のデータを基盤とした地図 API です。無料プランと定額の有料プランを提供しています。プライバシーエリアモードを含む静的地図画像、ジオコーディング、タイルを利用できます。このリポジトリでは、ローカルサーバーしか起動できない MCP クライアント向けに、stdio から HTTP への小規模なブリッジを提供しています。

MCP レジストリ：com.mapiron/maps

MapIron は、2026 年 11 月まで PinSharing という名称でした。以前の設定も引き続き使用できます。PinSharing からのアップグレードをご覧ください。

ほとんどのクライアント：ホスト型サーバーを直接使用

ホスト型 MCP サーバーは次の URL で利用できます。

https://api.mapiron.com/v1/mcp

設定方法は https://mapiron.com/docs/mcp をご覧ください。Claude Code の場合：

claude mcp add --transport http mapiron https://api.mapiron.com/v1/mcp --header "Authorization: Bearer YOUR_KEY"

ローカルサーバー（stdio）のみを実行するクライアント

claude_desktop_config.json を使用する Claude Desktop など、一部のクライアントはローカルの stdio MCP サーバーしか起動できません。その場合は、このブリッジを使用してください。

{
  "mcpServers": {
    "mapiron": {
      "command": "npx",
      "args": ["-y", "github:Software-Consulting/mapiron-mcp"],
      "env": { "MAPIRON_API_KEY": "ps_your_key" }
    }
  }
}

Git と Node.js 18 以降が必要です。

ツール

ツール	機能	消費数
geocode	住所や地名を座標に変換します	ジオコード 1 回
reverse_geocode	座標を住所または場所に変換します	ジオコード 1 回
static_map	マーカーまたはルート付きの地図画像を描画します	静的画像 1 枚
privacy_area_map	場所のおおよその位置を表示します（ピンではなく、網掛けのエリア）。正確な地点は決して表示しません	静的画像 1 枚
map_setup	インタラクティブマップ（MapLibre GL JS、Leaflet、OpenLayers）用のコードと URL	無料

設定

変数	必須	デフォルト	説明
MAPIRON_API_KEY	推奨	なし	MapIron API キー（ps_...）。設定しなくてもディスカバリーは利用できますが、ツールの呼び出しはサーバーの missing_key エラーを返します。
MAPIRON_MCP_URL	いいえ	https://api.mapiron.com/v1/mcp	ホスト型 MCP サーバーの URL。ホストが localhost または 127.0.0.1 の場合を除き、https: である必要があります。
MAPIRON_MCP_TIMEOUT_MS	いいえ	60000	HTTP タイムアウト（ミリ秒）。
MAPIRON_MCP_DEBUG	いいえ	未設定	1 に設定すると、デバッグログを stderr に書き込みます。

PinSharing からのアップグレード

何も変更しなくても問題ありません。

• github:Software-Consulting/pinsharing-mcp はこのリポジトリにリダイレクトされます。
• PINSHARING_API_KEY、PINSHARING_MCP_URL、PINSHARING_MCP_TIMEOUT_MS、PINSHARING_MCP_DEBUG も引き続き読み込まれます。両方の名称が設定されている場合は、MAPIRON_ の方が優先されます。
• 既存の ps_ キーはそのまま使えます。また、https://api.pinsharing.com/v1/mcp でも同じツールが引き続き利用できます。

新しい名称に移行するには、args のリポジトリを github:Software-Consulting/mapiron-mcp に変更し、変数名を MAPIRON_API_KEY に変更してください。

仕組み

このブリッジは、stdin から 1 行につき 1 つの JSON-RPC メッセージを読み取り、それぞれを HTTPS 経由でホスト型 MCP サーバーに転送します。応答は 1 行につき 1 つの JSON オブジェクトとして stdout に書き込まれます。ローカルには何も保存されません。API キーは設定されたサーバー（デフォルトでは api.mapiron.com）に Authorization ヘッダーでのみ送信され、ログやエラーに出力されることはありません。

プランと上限

MapIron には月間利用上限があり、超過分の請求はありません。カード情報なしで利用できる無料プランもあります。

• 料金と上限：https://mapiron.com/pricing
• 無料キー／ダッシュボード：https://mapiron.com/dashboard

帰属表示

地図データ © OpenStreetMap のコントリビューター。地図の結果や画像を表示する場所には、帰属表示を含めてください。

開発

npm test

このプロジェクトには、実行時または開発時の依存関係はありません。

ライセンス

MIT。MapIron は Wells Software Consulting LLC のサービスです。