Macau Stats

@pipeworx/macau-stats

マカオ（マカオ特別行政区）の公式統計 — DSEC（マカオ統計暨普查局／Direcção dos Serviços de Estatística e Censos）による143の主要指標（人口、訪問者数、ゲーミング収入、CPI、失業率、出生数・死亡数など）。

Pipeworx の一部です — AI エージェントを1882以上の稼働中データソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれの関係もありません。

ツール

• macau_indicators({ query? }) — 143の主要指標すべてのカタログ（ID、英語／中文／ポルトガル語の名称、報告頻度）です。3言語のいずれかのキーワードで絞り込むには、query を渡してください。
• macau_indicator({ id?, name?, periods? }) — 数値IDまたは名前／キーワードで指定した1つの指標の最新値と、DSECの一般統計データベースに信頼できる一致がある場合は過去の時系列データを返します（下記のID空間に関する注意を参照）。periods のデフォルト値は24です。
• macau_gaming_revenue() — マカオの月次賭博粗収入（澳門博彩毛收入、MOP百万単位）です。ゲーミング規制機関DICJがHTMLテーブルで公開しているものと同じ数値を、ここでは構造化データとして取得します。
• macau_population() — 四半期ごとの居住者総人口です。
• macau_tourism() — 月次の訪問者数です。
• macau_employment() — 失業率、総雇用者数、月間賃金中央値を1回の呼び出しで取得します。

認証

キー不要です。登録もAPIキーも必要ありません。DSECの /zh-MO/Service/WebService ページでは「お問い合わせ」と案内されるウィジェット製品について説明していますが、その記述はブランド付きの埋め込み機能に関するものであり、ここで使用している生データの呼び出しには関係ありません。

データソース

• https://www.dsec.gov.mo/TimeSeriesDatabase.asmx — DSECの公開SOAPウェブサービス（WSDLは ?WSDL）。昔ながらのASP.NET ASMXです。各SOAP操作は通常のHTTP GET（フレームワークのHttpGetバインディング）にも応答するため、このパックはGETとクエリ文字列を使って呼び出し、XMLレスポンスを解析します。SOAPエンベロープは不要です。

次の担当者への注意点

• 互いに独立した2つのID空間があります。 143個の厳選された KeyIndicatorID（getKeyIndicatorList／getKeyIndicatorValue）は、一般的な IndicatorID カタログ（getIndicatorID／getIndicatorByID／getIndicatorLatestNValues）と同じ番号体系ではありません。getIndicatorByID(15) に KeyIndicatorID 15を指定すると、空の結果が返ります。文書化された対応表はありません。このパックでは、一般カタログを検索して主要指標名と一致する説明を探し、系列がちょうど1つに特定できた場合にのみ対応付けを信頼します（曖昧な検索結果または空の検索結果は「信頼できる履歴なし」とし、推測しません）。「Live births」→IndicatorID 9014で動作を確認済みです。「Gross revenue of games of chance」は、厳選された主要指標セットにのみ存在し、一般カタログにはないことを確認済みです。
• 厳選された主要指標のエンドポイント（getKeyIndicatorValue）が返すのは最新値のみです。 期間パラメーターも履歴もありません。実際の時系列データを取得するには上記の一般カタログとの対応付けが必要ですが、すべての指標で解決できるわけではありません。
• チャート操作（getChart、getCommonChart）が返すのは、構造化された数値ではなくbase64エンコードされたPNG画像（ChartData）です。 データAPIとしては使用できないため、このパックでは呼び出しません。
• 言語の列挙値： English、TraditionalChinese、SimplifiedChinese、Portuguese です。Chinese ではありません（この値は.NETの変換エラーとなり、500を返します）。
• このパックは、ゲーミング規制機関DICJのHTMLテーブルをスクレイピングする方法に代わるものです。同じ月次ゲーミング粗収入の数値を、ここでは整ったXMLとして取得できます。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します：

{
  "mcpServers": {
    "macau-stats": {
      "url": "https://gateway.pipeworx.io/macau-stats/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/macau-stats/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx の共有メタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツールも返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントでは現在、このパック固有のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認する際の信頼できる情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使えば、このパックが対象としていない質問にも対応できます。ask_pipeworx がカタログ全体を対象にルーティングするため、MCP サーバーをもう 1 つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1882 以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/macau_indicators \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにアカウントは不要です。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/macau_indicators を使います。ツールを検索するには、POST https://gateway.pipeworx.io/v1/tools/search_packs に {"query":"..."} を指定します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "macau-stats": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-macau-stats"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-macau-stats

stdin/stdout を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを返します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントとフルゲートウェイの両方で使えます。

ask_pipeworx({ question: "your question about Macau Stats data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT