Census Trade

mcp-census-trade

Census Trade MCP — 米国国勢調査局の国際貿易データ

Pipeworx の一部です — AI エージェントを1679以上のライブデータソースにつなぐMCPゲートウェイです。

ツール

ツール	説明
census_imports	HS商品コードや国を指定して、米国の輸入データを検索します。輸入額、数量、商品詳細を返します。country には英語の国名（例："China"）を指定します。ある国からの輸入総額を調べる場合は hs_code を省略し、全ての国を合算する場合は country を省略します。
census_exports	HS商品コードや国を指定して、米国の輸出データを検索します。輸出額、数量、商品詳細を返します。country には英語の国名（例："Mexico"）を指定します。ある国への輸出総額を調べる場合は hs_code を省略し、全ての国を合算する場合は country を省略します。
census_trade_balance	指定した年について、米国と特定の国との貿易収支を確認します。貿易収支額と、最終用途の商品カテゴリー別の内訳を返します。
census_trade_trends	1つの貿易相手国との月次の米国貿易動向を調べます。国別の月ごとの輸入と輸出を返し、季節性や変化を確認できるよう、HS商品に絞り込むこともできます。国の指定は必須です。絞り込みなしの月次クエリでは全ての貿易相手国が対象となり、Census APIが時間内に結果を返せません。全ての国の合計には、代わりに census_imports / census_exports を使用してください。

クイックスタート

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

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

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

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

これは意図された動作であり、意図せず多重化されているわけではありません。メタツールを使うと、このパックが扱わない質問にも、カタログ全体にルーティングする ask_pipeworx を通じて回答できます。そのため、MCP サーバーを追加で用意する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点に見合わない場合は、複数のパックエンドポイントに接続する代わりに、フルゲートウェイに一度だけ接続してください。

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/census_imports \
  -H 'Content-Type: application/json' \
  -d '{"country":"European Union","hs_code":"30","year":"2024"}'

最初の呼び出しにはアカウントは必要ありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/census_imports を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

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

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

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

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

npx -y @pipeworx/mcp-census-trade

stdin/stdout 経由で MCP を扱い、initialize/tools/list/tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じデータソースと同じツールを利用できますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Census Trade data" })

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

詳細情報

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

ライセンス

MIT