NSW Fuel

mcp-au-nsw

MCP サーバー。NSW 政府の API を利用できます。 Claude（または任意の MCP クライアント）に、「今すぐ UNSW から Circular Quay まで行くには？」、「M4 で事故はありますか？」、「電気工事士のライセンス 241132C は有効ですか？」、「Parramatta 近くで最も安いディーゼル燃料はどこですか？」 といった質問をすると、最新情報を取得できます。

サーバー	対応内容	データソース	キー
transport	経路検索、リアルタイムの出発情報、運行アラート（電車、メトロ、バス、ライトレール、フェリー）、パーク＆ライド駐車場	TfNSW Open Data Hub	TfNSW キー
roads	リアルタイムの交通障害（事故、道路工事、洪水、火災、イベント）と通行料金	TfNSW Open Data Hub	TfNSW キー（同じキー）
licences	NSW の公的登録簿 15 種類のライセンス確認（技能職従事者、不動産業者、警備、酒類、薬局、WHS ライセンスなど）	API.NSW	登録簿ごとに API.NSW キー 1 つ
fuel	NSW と TAS のリアルタイム燃料価格	API.NSW	API.NSW キー

各サーバーは個別のサブコマンドなので、必要なものだけを追加できます。

クイックスタート

1. API キーを取得する（無料）

TfNSW Open Data Hub（transport と roads 用。1 つのキーで両方に対応）

1. 登録します：https://opendata.transport.nsw.gov.au/data/user/register
2. ログインします：https://opendata.transport.nsw.gov.au/data/user/login
3. プロフィールアイコンをクリックし、API Tokens を選択して、名前を入力し、Create API Token をクリックします。
4. トークンをすぐにコピーしてください。再度表示することはできません。このトークンが NSW_TRANSPORT_API_KEY です。

公式ガイド：https://opendata.transport.nsw.gov.au/developers/userguide

API.NSW（fuel と licences 用）

1. 登録します：https://api.nsw.gov.au/Account/Register（ログイン：https://api.nsw.gov.au/Account/Login）
2. My Apps → Add new app に移動します：https://api.nsw.gov.au/DeveloperApp/AppCreate API プロダクトを 1 つ追加します。各アプリに追加できる API プロダクトは 1 つだけなので、利用する API ごとにアプリを作成してください （例：Fuel API 用に 1 つ、Trades 登録簿用に 1 つ）。
3. 各アプリの API Key と API Secret を対応する環境変数に設定します （NSW_FUEL_API_KEY / NSW_FUEL_API_SECRET、NSW_TRADES_API_KEY / NSW_TRADES_API_SECRET など。 一覧については licences セクションを参照してください）。 無料プランでは、アプリごとに月 2,500 回まで呼び出せます。

2. uv をインストールする（まだの場合）

curl -LsSf https://astral.sh/uv/install.sh | sh

3. MCP クライアントにサーバーを追加する

Claude Code

claude mcp add nsw-transport -e NSW_TRANSPORT_API_KEY=your-tfnsw-key -- uvx mcp-au-nsw transport
claude mcp add nsw-roads     -e NSW_TRANSPORT_API_KEY=your-tfnsw-key -- uvx mcp-au-nsw roads
claude mcp add nsw-fuel      -e NSW_FUEL_API_KEY=your-key -e NSW_FUEL_API_SECRET=your-secret -- uvx mcp-au-nsw fuel
claude mcp add nsw-licences  -e NSW_TRADES_API_KEY=your-key -e NSW_TRADES_API_SECRET=your-secret -- uvx mcp-au-nsw licences

licences を使用する場合は、登録した各登録簿のキーのペアを渡してください。キーがない登録簿は利用できません。

Claude Desktop / Cursor / その他のクライアント：利用するサーバーを MCP 設定ファイル（claude_desktop_config.json、.cursor/mcp.json など）に追加します。

{
  "mcpServers": {
    "nsw-transport": {
      "command": "uvx",
      "args": ["mcp-au-nsw", "transport"],
      "env": { "NSW_TRANSPORT_API_KEY": "your-tfnsw-key" }
    },
    "nsw-roads": {
      "command": "uvx",
      "args": ["mcp-au-nsw", "roads"],
      "env": { "NSW_TRANSPORT_API_KEY": "your-tfnsw-key" }
    },
    "nsw-fuel": {
      "command": "uvx",
      "args": ["mcp-au-nsw", "fuel"],
      "env": { "NSW_FUEL_API_KEY": "your-key", "NSW_FUEL_API_SECRET": "your-secret" }
    },
    "nsw-licences": {
      "command": "uvx",
      "args": ["mcp-au-nsw", "licences"],
      "env": {
        "NSW_TRADES_API_KEY": "your-key", "NSW_TRADES_API_SECRET": "your-secret",
        "NSW_PROPERTY_API_KEY": "your-key", "NSW_PROPERTY_API_SECRET": "your-secret"
      }
    }
  }
}

uvx は最初にダウンロードしたバージョンをキャッシュします。新しいリリースを取得するには、uvx mcp-au-nsw@latest ... を使用するか、uv cache clean mcp-au-nsw を実行してください。

サーバーの動作

• 名前で場所を指定できます。 場所を受け取るツールでは、名前（「Town Hall」、「17 High St Kensington」、「Sydney Opera House」）、停留所 ID、または lat,lng を指定できます。
• 推測はしません。 名前がほぼ同程度に複数の場所に一致する場合（例：「UNSW」にはライトレールの停留所が 2 つあり、「Sydney Airport」には国内線と国際線の駅があります）、ツールは 1 つを選ばず候補を返すため、アシスタントが確認できます。
• ライブデータをキャッシュせずに取得します。 呼び出しごとに最新データを取得します。応答には安定した ID（停留所 ID、駅コード）が含まれるため、分析用の独自の参照データを作成できます。
• シドニーの現地時刻です。 時刻はすべてシドニー時間の YYYY-MM-DD HH:MM 形式です。

transport サーバー

ツール	説明
plan_trip	区間、乗り場、リアルタイムの遅延、運行情報を含む、A地点からB地点までの経路を検索します。到着時刻の指定や交通手段の制限にも対応しています
get_departures	駅または停留所からの次の出発便を、リアルタイムの遅延と乗り場情報とともに取得します
get_service_alerts	現在の運行障害や線路工事を取得します。交通手段、路線（T1、L2、333など）、または停留所で絞り込めます
find_stops	駅、停留所、埠頭を名前で検索し、停留所IDと交通手段を返します
get_car_park_availability	Transport Park&Ride駐車場の空きスペース数を、駐車場名または場所からの距離で取得します
get_car_park_history	指定日のPark&Ride駐車場の混雑状況を、時間ごとの利用台数、ピーク時の利用台数、満車になった時刻とともに取得します

プロンプトの例：

• 「今すぐUNSWからCircular Quayへ行くにはどうすればいいですか？」
• 「午後6時までにManly Wharfに着く必要があります。Martin Placeを何時に出ればいいですか？」
• 「Town Hallから次の電車は何時ですか？」
• 「今日はT1に何か問題がありますか？」
• 「Tallawong Park&Rideに空きスペースは残っていますか？」
• 「昨日、Tallawong P1駐車場は何時に満車になりましたか？」

roads サーバー

ツール	説明
get_traffic_hazards	事故、故障、道路工事、洪水、火災、山岳地帯の状況、主要イベントを取得します。地域や道路名、または場所からの距離で絞り込めます
calculate_toll	2地点間の通行料金（AUD）と利用する高速道路を、最速の無料ルートと比較して取得します

プロンプトの例：

• 「今、M4で何か起きていますか？」
• 「今週末、Parramattaの近くで道路工事やイベントはありますか？」
• 「ParramattaからSydney International Airportまでの通行料金はいくらで、どれくらい時間を短縮できますか？」

通行料金はTransport for NSWによる推定額であり、実際の請求額とは異なる場合があります。

licences サーバー

NSW の公開登録簿でライセンスを確認します。どの登録簿も同じ方法で利用できます。ライセンス番号で照会する、個人名または事業者名で検索する、公開記録の全情報を取得する、の3つです。

ツール	機能
verify_licence	ライセンス番号を確認します。ステータス（有効／期限切れなど）、有効期限、ライセンスの種類、保有者を確認できます
search_licences	個人名または事業者名でライセンスを検索します（部分一致にも対応）。有効なものが先に表示されます
get_licence_details	記録の全情報を取得します。ライセンス区分（対象となる業務）、条件、履歴、事業所、関連する人物とライセンス、コンプライアンス対応（懲戒処分、停止、起訴、公開警告、保険請求）が含まれます
list_registers	登録簿の一覧、対象範囲、設定状況を確認できます

登録簿（register の値）	対象	環境変数	登録
trades	建設業者および技能職従事者	NSW_TRADES_API_KEY、NSW_TRADES_API_SECRET	Trades API
property	不動産業者、不動産管理者、区分所有管理者	NSW_PROPERTY_API_*	Property API
security	警備員および警備事業者	NSW_SECURITY_API_*	Security API
liquor	酒類ライセンスおよび施設	NSW_LIQUOR_API_*	Liquor API
motor	自動車販売業者、修理業者、リサイクル業者	NSW_MOTOR_API_*	Motor API
conveyancer	不動産譲渡手続きの専門家	NSW_CONVEYANCER_API_*	Conveyancer API
lotteries	販売促進目的の宝くじおよび偶然性に基づくゲーム	NSW_LOTTERIES_API_*	Lotteries API
owner_builder	オーナー施工者許可	NSW_OWNER_BUILDER_API_*	Owner Builder Permit API
home_building_compensation	住宅建築補償証明書	NSW_HOME_BUILDING_COMPENSATION_API_*	Home Building Compensation API
building_practitioners	設計・建築の専門家、エンジニア	NSW_BUILDING_PRACTITIONERS_API_*	Design and Building Practitioners API
asbestos	アスベスト除去および解体ライセンス	NSW_ASBESTOS_API_*	Asbestos and Demolition
high_risk_work	高リスク作業ライセンス（フォークリフト、クレーンなど）	NSW_HIGH_RISK_WORK_API_*	High Risk Work
white_cards	建設業の安全講習および交通整理のカード	NSW_WHITE_CARDS_API_*	White Cards
trainers	登録済み職業訓練機関	NSW_TRAINERS_API_*	Trainers and Providers API
pharmacies	薬局施設および経済的利害関係者	NSW_PHARMACIES_API_*	Register of Pharmacies

NSW_X_API_* は NSW_X_API_KEY と NSW_X_API_SECRET を意味します。

プロンプトの例：

• 「電気技師ライセンス241132Cは有効ですか？電気工事も対象ですか？」
• 「私の建築業者である Smith Constructions は、有効なライセンスを保有していて、懲戒処分を受けたことがありますか？」
• 「この不動産業者はライセンスを保有していますか？」

記録は公開登録簿から直接取得され、ライセンス保有者や関連する人物の氏名、役割、住所が含まれる場合があります。

fuel サーバー

ツール	内容	API 呼び出し数
find_fuel_prices	地域、郵便番号、または座標の周辺で、指定した燃料の最安値（または最寄り）のガソリンスタンドを検索します	1 回（地域または郵便番号を指定する場合は 2 回）
get_station_prices	1 つのガソリンスタンドの現在の価格をすべて取得します	1 回
search_stations	名前、ブランド、地域、または郵便番号でガソリンスタンドを検索します	1 回
list_fuel_types	燃料の種類のコード（U91、E10、P98、DL、...）を取得します	1 回

価格は 1 リットルあたりのセント単位です。

プロンプトの例：

• 「UNSW 近くで最も安いディーゼルはどこですか？」
• 「BP Redfern の現在の価格はいくらですか？」

開発

git clone https://github.com/fisher98kim/mcp-au-nsw
cd mcp-au-nsw
uv sync
uv run pytest

# run a server locally with keys from .env
uv run --env-file .env mcp-au-nsw transport

Claude Code でローカルの変更を試すには：

claude mcp add nsw-transport-dev -e NSW_TRANSPORT_API_KEY=... \
  -- uv run --directory /path/to/mcp-au-nsw mcp-au-nsw transport

リリース

1. pyproject.toml とすべての registry/*.json の version を更新します（一致しているかどうかをテストで確認します）。
2. v<version> というタグを付けて GitHub リリースを作成します。ワークフローによって PyPI に公開された後、 MCP Registry のエントリー（サーバーごとに 1 つ）が更新されます。

ライセンス

MIT。NSW 政府または Transport for NSW との提携や、これらの組織による推奨を受けているものではありません。データは、API.NSW および TfNSW Open Data Hub から、それぞれの利用規約に基づいて提供されています。