Neshan Maps

neshan-mcp：AI エージェント向け Neshan イラン地図 MCP サーバー

AI エージェントが Neshan（نشان）で場所を検索し、ルートを調べ、Tehran の交通規制区域を確認できるようにします。
neshan-mcp は、イランの地図・ナビゲーションアプリ Neshan 向けの非公式な読み取り専用 MCP サーバーです。
11 個のツールで、場所の検索、場所の詳細、レビュー、写真やメニュー、近くの場所、逆ジオコーディング、市の大気質、 自動車、オートバイ、自転車、徒歩、バス／地下鉄のルート、複数の場所への所要時間、Tehran の交通規制区域の確認ができます。 API キーやアカウントは不要です。

AI エージェント向け · クイックスタート · できること · ツール · FAQ · فارسی

AI エージェント向け

• 概要： neshan.org/maps（イランの地図 Neshan）向けの非公式 MCP サーバー（Model Context Protocol）です。ペルシャ語でも英語でも問い合わせできます。回答では Neshan のペルシャ語の名称、住所、手順が保持されます。
• インストール： uvx neshan-mcp または claude mcp add neshan -- uvx neshan-mcp。トランスポート：stdio。uv が必要です（Python 3.10 以降）。
• 認証： 不要です。API キーやアカウントは必要ありません。NESHAN_MCP_PROXY（HTTP プロキシ URL、またはカンマ区切りのリスト）は任意です。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用です。ログイン、場所の保存、レビューの投稿はできないため、ツールの呼び出し前に確認する必要はありません。
• ツール： 11 個あり、すべて ns_ で始まります。一般的な使用順序：ns_search -> ns_place / ns_reviews / ns_photos / ns_nearby； ns_search -> ns_travel_times -> ns_route；Tehran 中心部への車での移動前に ns_zone_check。
• 使用する場面： イラン国内の場所、ある場所の近くにあるもの、営業中かどうか、評判やメニュー、座標に対応する住所、市の大気汚染の状況、住所が Tehran の交通規制区域内かどうか、A 地点から B 地点への行き方や所要時間について、現在または指定した時刻の情報をユーザーが尋ねた場合。
• 使用しない場面： ユーザーがイラン国外の場所、タクシーや配達の料金、Neshan アカウントへの場所の保存を求めている場合。
• 出力： 簡潔な JSON。座標は lat,lng（緯度が先）です。距離はメートルまたは km、時間は分、運賃は Toman、レビューの日付はペルシャ暦、出発時刻は Tehran 時間です。
• ネットワーク： すべてのツールはイラン国内の接続から動作します。国外の接続では、テスト時に ns_nearby 以外のすべてのツールが動作しました。ns_nearby は Neshan から HTTP 403 が返されるため、利用するには NESHAN_MCP_PROXY にイラン国内のプロキシを設定してください。
• 機械可読情報： server.json と iran-mcp カタログ。

理由

Neshan はイランの情報を詳しく把握しています。営業時間やレビューを確認できる店舗、リアルタイムの交通状況、テヘランの交通規制区域と偶数・奇数ナンバー規制、バス、BRT、地下鉄の路線などです。開発者向け API の利用には有料キーが必要で、ウェブマップはクリック操作向けに作られています。 neshan-mcp を使うと、エージェントはウェブマップに表示されるものと同じ公開データを、少数の簡単な呼び出しで取得できます。

あなた： アーザーディー塔からテヘラン大バザールまで車でどれくらいかかりますか？交通規制区域に入りますか？

エージェント： 呼び出し ns_search("برج آزادی")、ns_search("بازار بزرگ تهران")、続いて ns_route(origin="35.699739,51.338097", destination="35.671897,51.422428", steps=false)

Neshan によると、ジョムフーリー・エスラーミー通りとモスタファー・ホメイニー通り経由で、所要時間は48分（13 km）です。サエイーディー高速道路とショウシュ経由のルートは16 kmで、45分かかります。3つのルートはすべて、06:30から18:00まで適用される交通規制区域（طرح ترافیک）と偶数・奇数ナンバー規制区域に入ります。バザール自体も両方の区域内にあります。

_{2026-10-31 17:21（テヘラン時間）にライブ呼び出しで得られた実際の回答です。所要時間は交通状況によって変わります。}

すべての応答は、必要なフィールドだけを含む簡潔なJSON形式です。そのため、エージェントのコンテキストを圧迫しません。

できること

• 場所を検索：都市や地点の近くにある、カフェ、薬局、ガソリンスタンド、通り、広場などを名前やカテゴリで検索します。サイトと同様に、現在営業中かどうかや評価で絞り込めます。
• 場所の情報を確認：住所、座標、電話番号、ウェブサイト、評価と投票数、現在営業中かどうか、曜日ごとの営業時間、最新の写真を取得します。
• レビューを読む：新着順または Neshan のおすすめ順でレビューを確認し、メニューアルバムを含む写真を閲覧します。
• 周辺情報を確認：場所の周辺にあるレストラン、カフェ、公園、トイレ、銀行、ATM、駐車場、バス停を確認します。
• 逆ジオコーディング：座標を通りの住所と州に変換します。
• 大気質を確認：都市の今日のAQI、汚染物質とすべての観測所、または地点の大気質指数を取得します。
• ルートを検索：車、バイク、自転車、徒歩での代替ルート、リアルタイムの所要時間、ペルシャ語のターンバイターン案内、最大3か所の立ち寄り地点を取得します。
• 時刻を指定して計画：出発時刻または到着時刻を指定し、Neshan の交通予測に基づいて計画します（車、テヘラン、カラジ、マシュハド）。
• 所要時間で順位付け：1つの出発地から最大10か所までの所要時間を比較し、最短順に並べます。
• テヘランの規制区域を確認：地点が交通規制区域または偶数・奇数ナンバー規制区域内にあるか、ルートがそれらの区域に入るかを確認します。区域や有料道路を避けることもできます。
• 公共交通機関を利用：路線、停留所、徒歩区間、トマン建ての運賃を含むバス、BRT、地下鉄のルートを取得します。
• 読み取り専用設計：ログイン、保存、投稿はありません。

プロンプトの例：

• 「ミラード塔の近くで、現在営業中かつ評価が4以上の24時間営業の薬局を探してください。」
• 「ギーシャにある Lamiz Coffee は今営業していますか？電話番号と、利用者の評判も教えてください。」
• 「ミラード塔のメニュー写真を見せてください。」
• 「この3つの支店のうち、アーザーディー広場から車で最も近いのはどこですか？」
• 「明日9時にミラード塔に着く必要があります。アーザーディー広場から何時に出発すればよいですか？」
• 「フェルドウスィー広場はテヘランの交通規制区域内ですか？」
• 「今日のイスファハーンの大気汚染はどのくらいですか？」
• نزدیک‌ترین داروخانه شبانه‌روزی به برج میلاد کجاست؟
• از میدان آزادی تا بازار تهران با ماشین چقدر راه است؟ وارد طرح ترافیک می‌شوم؟
• با مترو و اتوبوس از میدان آزادی به برج میلاد چطور بروم و هزینه‌اش چقدر است؟

クイックスタート

uv が必要です。API キーもアカウントも必要ありません。

claude mcp add neshan -- uvx neshan-mcp

{
  "mcpServers": {
    "neshan": { "command": "uvx", "args": ["neshan-mcp"] }
  }
}

{
  "servers": {
    "neshan": { "type": "stdio", "command": "uvx", "args": ["neshan-mcp"] }
  }
}

codex mcp add neshan -- uvx neshan-mcp

[mcp_servers.neshan]
command = "uvx"
args = ["neshan-mcp"]

{
  "mcpServers": {
    "neshan": { "command": "uvx", "args": ["neshan-mcp"] }
  }
}

ツール

地点は lat,lng 形式です。例：35.6997,51.3380。場所 ID は ns_search から取得します。

11個すべてのツールに readOnlyHint: true が注釈されています。

仕組み

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  neshan-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  neshan.org/maps/pwa-api   search, places, reviews, photos, routes, transit, air quality

neshan-mcp はローカルで動作し、ホスト型サーバーを介さず、API キーも使わずに neshan.org/maps ウェブアプリと同じエンドポイントを呼び出します。リクエストは Chrome を装うクライアント経由で送信され、ウェブアプリ自身からのリクエストのように見えます。同時に送信するリクエストは最大3件で、わずかな時間差を加えます。結果をキャッシュし（場所と住所は5分間、リアルタイムのルートは1分間、公共交通機関、区域、大気質は10分間）、失敗した呼び出しは最大2回再試行します。また、neshan.org 以外とは通信しません。

Neshan のウェブアプリでは、回答の大部分がエンコードされています。回答はシャッフルされた base64 テキストとして届き、公共交通機関の回答は XOR でもエンコードされています。サーバーはウェブアプリ自身のスクリプトと同じ方法で回答をデコードします。Neshan が方式を変更した場合、サーバーはブラウザーが現在の JavaScript を読み込むのと同じ方法で、サイトから新しい値を一度読み込み、再試行します。それでも読み取れない回答は、捏造したデータではなくエラーとして報告されます。

知っておくと便利なこと

• 座標の形式は lat,lng です。 緯度が先です。順序を逆にすると、ヒントとともに拒否されます。
• near には都市名または地点を指定します。 英語名またはペルシャ語名で指定できる23の大都市（Tehran、Mashhad、Isfahan、Shiraz、 Tabriz、Karaj、Qom、Ahvaz、...）に対応しています。小さな町の場合は、クエリに名前を入れてください。
• 検索結果は最大30件で、ページ分けはありません。スポンサー付きの結果（サイト上で آگهی と表示されるもの）は除外されます。 open_now と min_rating は、Neshan 独自のフィルター（営業中、3.5以上、4以上、4.5以上）を使用します。
• 移動時間は Neshan による推定値で、現在出発する場合、または depart_at に指定した場合のものです。出発時刻と到着時刻は Tehran 時間（グレゴリオ暦の YYYY-MM-DD HH:MM）です。Neshan は Tehran、Karaj、Mashhad で車の移動時間を提供しています。
• 有料道路にはフラグが付きます（toll_road）が、料金は表示されません。Neshan のウェブアプリでは通行料金が表示されないためです。
• 公共交通機関の移動時間はありません。 Neshan のウェブマップでは、バスと地下鉄の運賃、路線、停留所は確認できますが、所要時間は表示されません。
• ns_nearby の利用にはイラン国内からの接続が必要です。 海外からのリクエストに対して Neshan は HTTP 403 を返します。イランのプロキシに NESHAN_MCP_PROXY を設定するか、地点の lat,lng を near に指定して ns_search を使用してください。
• 大気質情報の都市名には英語名（Tehran、bandar abbas）または上記23都市のペルシャ語名を使用します。 観測所のない都市では「データなし」と表示されます。
• 出力はペルシャ語です。 名前、住所、営業時間（ペルシャ数字）、手順、レビューの日付は、Neshan の表示どおりです。
• できないこと： ログイン、保存、レビュー、イラン国外の場所の検索、リアルタイムの交通事故情報、気温、AI によるレビュー要約には対応していません（Neshan はログインユーザーにのみこれらを提供します）。

よくある質問

npx @modelcontextprotocol/inspector uvx neshan-mcp

設定

ペルシャ語：Neshan マップ MCP サーバー

claude mcp add neshan -- uvx neshan-mcp

開発

git clone https://github.com/sepehr071/neshan-mcp && cd neshan-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # calls neshan.org
uv build

場所関連のツールは src/neshan_mcp/maps.py、ルート検索ツールは src/neshan_mcp/routes.py、Neshan の応答の復号処理は src/neshan_mcp/codec.py にあります。各ツールは、エージェントが使用する場面を説明する docstring を備えた、型付きの非同期関数です。Issue や PR は歓迎します。

リリースするには、pyproject.toml と server.json のバージョンを更新してから、v* タグをプッシュしてください。GitHub Actions が PyPI に公開します。

関連サーバー

• Balad（イランの別の地図サービス）向けの balad-mcp：場所、口コミ、車でのルート
• iran-mcp：イランのサービスに対応するすべての MCP サーバーのカタログ
• イラン国内の航空便、列車、バス、ホテル向けの mrbilit-mcp
• イラン各地のヴィラや宿泊施設向けの jabama-mcp
• Snappfood と SnappMarket 向けの snapp-mcp

免責事項

非公式のプロジェクトであり、Neshan との提携関係や、Neshan による推奨はありません。読み取り専用で、予告なく変更される可能性のある neshan.org ウェブアプリのエンドポイントを使用します。所要時間、区域の規制時間、大気質は参考情報です。これらを判断の根拠とする前に、公式情報をご確認ください。

作成者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。詳しくはLinkedInでつながるか、GitHub の @sepehr071をフォローしてください。イランのウェブサイト向けの MCP サーバーをさらにご覧いただけます。すべてiran-mcpに掲載されています。このプロジェクトが時間の節約に役立ったら、リポジトリにスターを付けていただけると、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT