Kyrodata — Brazil Trade, Crop & Commodity Data

Kyrodata は、リモートのモデルコンテキストプロトコルサーバーです。 インストールや実行は不要です。ホストされたエンドポイントをエージェントに指定し、 API キーを渡すだけです。

https://mcp.kyrodata.com/mcp

自然な言葉で質問するだけで、「今年のブラジルのコーヒー輸出は昨年と比べてどうだった？」のように尋ねると、 測定値、対象期間、その情報の出典が得られます。

キーを取得する

kyrodata.com/user/api-keysで作成してください。一度しか表示されません。 クエリにはプランに含まれるクレジットが使用されます。コネクターは別途契約する必要はありません。

接続する

ヘッダーに対応した任意のエージェント（Cline、Claude Code、Cursor、VS Code、Codex、n8n、 Zapier、Make）：

{
  "mcpServers": {
    "kyrodata": {
      "url": "https://mcp.kyrodata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KYRODATA_API_KEY" }
    }
  }
}

コマンドラインでの同等の方法：

claude mcp add --transport http kyrodata https://mcp.kyrodata.com/mcp \
  --header "Authorization: Bearer $KYRODATA_API_KEY"

codex mcp add kyrodata --url https://mcp.kyrodata.com/mcp \
  --bearer-token-env-var KYRODATA_API_KEY

gemini mcp add --transport http --header "Authorization: Bearer $KYRODATA_API_KEY" \
  kyrodata https://mcp.kyrodata.com/mcp

チャットアシスタント（claude.ai、ChatGPT）にはキーを入力する欄がなく、代わりに認証を求められます。 同じ URL を使って Kyrodata をカスタムコネクターとして追加し、プロンプトが表示されたらサインインしてください。 クライアントごとの手順は、こちらをご覧ください：kyrodata.com/developers。

利用できる機能

ブラジルの外国貿易（MDIC/ComexStat）、作物生産、需給バランス、気候データ、商品価格予測を読み取り専用ツールで利用できます。

ツール	回答する内容
kyrodata_search	公開貿易カタログを検索
kyrodata_fetch	ID を指定して公開貿易文書を開く
kyrodata_resolve_entity	国、HS コード、または商品を特定
kyrodata_compare_trade	同じ期間の輸出入を比較
kyrodata_list_trade_series	月次貿易データの生系列を行形式で取得
kyrodata_list_trade_partners	成長率を含む主要な貿易相手国を取得
kyrodata_get_heading_overview	HS 項目（SH4）の概要
kyrodata_resolve_comparison_window	同条件で比較できる期間を作成
kyrodata_get_supply_demand_balance	需給バランスシート
kyrodata_get_climate_reading	気候データと作物の物理的損失
kyrodata_get_hub_summary †	商品ハブの概要と予測の判定
kyrodata_explain_pyramid_level †	予測ピラミッドの一つのレベルを説明
kyrodata_run_report	カタログ内のレポートを実行
kyrodata_get_data_coverage	データの対象範囲と直近の確定済み月
kyrodata_get_credit_balance	このキーのクレジット残高と上限（無料）

稼働中のエンドポイントで tools/list を実行した結果が、正式なツール一覧です。

† 価格予測に関する2つのツールは追加プランの一部です。貿易、気候、需給関連のツールは含まれません。

回答の仕組み

• ウィンドウは、設計上、同じ重みで比較されます。 3 か月分と 1 年分を比較することはありません。サーバーは長さの異なるウィンドウを拒否し、条件に一致する最大のウィンドウをラベル付きで返します。
• すべての回答で、対象のウィンドウとデータソースが明示されます。
• 「シグナルなし」も、データが判定を裏付けない場合には有効な回答です。
• 読み取り専用です。 ツールが何かを書き込んだり、削除したり、購入したりすることはありません。

ローカルコマンドとして実行する場合（ほぼ間違いなく、その必要はありません）

bridge/server.py は stdio から HTTP へのフォワーダーで、Dockerfile はこれをパッケージ化します。これはサーバーではありません。 サーバーはリモートにあります。リモート MCP に対応するクライアントであれば、上記の URL に直接接続してください。経由するホップが 1 つ減り、インストールも不要です。このブリッジが必要なのは、ローカルコマンドしか起動できないクライアントと、ビルド、起動、イントロスペクションができないものを評価対象にしないディレクトリの、2 つの場合に限られます。

docker build -t kyrodata-mcp .
docker run -i --rm -e KYRODATA_API_KEY=kd_live_... kyrodata-mcp

このブリッジは独自のツールを実装しません。initialize、tools/list、tools/call はそのまま転送されるため、サーバーと内容が食い違う可能性のあるカタログの複製はここにはありません。サードパーティー依存関係はなく、キーがイメージに含まれることもありません。

注意事項

• トランスポートは streamable-http です。非推奨の HTTP+SSE トランスポートは提供していません。
• 認証情報がない場合、エンドポイントは 401 を返します。403 は返しません。
• キーは Authorization ヘッダーに設定してください。クエリ文字列にキーを含めることはできません。クエリ文字列はブラウザーの履歴やプロキシログに残るためです。

このリポジトリの内容は MIT ライセンスです。ホストされているサービスには、独自の利用規約があります。