Idb

@pipeworx/idb

米州開発銀行（IDB）のプロジェクト調達 — 入札公告、契約受注、5つの多国間開発銀行を対象とした相互資格停止チェックをリアルタイムで提供します。すべて、IDBの認証不要のCKANオープンデータポータルをデータソースとしています。

Pipeworx の一部です。AI エージェントを1881以上のリアルタイムデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、その承認や公開を受けたものでもありません。

ツール

• idb_search_notices(...) — 中南米・カリブ海地域（LAC）の26か国を対象に、IDBの調達公告（入札、関心表明、一般公告・個別公告、受注通知）をリアルタイムで検索します。デフォルトでは、期限が過ぎていない公開中の公告を対象とします。
• idb_get_notice(notice_id) — 1件の公告の全記録を取得します。
• idb_search_awards(...) — 国、企業、セクター、年で、IDBプロジェクトの受注済み契約約15万9,000件を検索します。
• idb_check_mdb_debarment(name, ...) — IDB独自の資格停止リストに加え、世界銀行グループ、アジア開発銀行、アフリカ開発銀行、EBRDの相互資格停止リストで名前を照合します（5つの銀行を対象に「このベンダーは資格停止になっているか」という問いに答える共通フィードです）。

認証

不要です。

データソース

• https://data.iadb.org/dataset/project-procurement-bidding-notices-and-notification-of-contract-awards — 入札公告および受注通知（約37,000件）。
• https://data.iadb.org/dataset/idb-project-procurement-contract-awards-data — 受注レベルの契約詳細（約159,000件。データセットのページでは約70MBのCSVが提供されていますが、同じデータがCKANのDatastore経由でも公開されているため、ここにあるすべてのツールはファイルをダウンロードせず、サーバー側SQLでリアルタイムにクエリします）。
• https://data.iadb.org/dataset/dataset-of-sanctioned-firms-and-individuals — IDBの資格停止情報およびWBG／ADB／AfDB／EBRDの相互資格停止情報（約1,300件）。

3つのデータセットすべてに、data.iadb.org/api/3/action/datastore_search_sql 経由でクエリします（CKAN Datastore、認証不要）。このパックを扱う方への注意事項：

• ここにあるすべてのリソースはCKAN Datastoreで有効になっています — 各データセットの package_show は datastore_active: true を返します。これにより、受賞契約の70MBファイルをダウンロードしてキャッシュする代わりに、SQLでリアルタイムにクエリできます。新しいIDBデータセットのダウンロードが必要だと判断する前に、datastore_active を確認してください。
• 通常の /files/download/<id> URLはAWS WAFのボットチャレンジの背後にあります（リクエストをそのまま送ると、HTTP 202と x-amzn-waf-action: challenge が返されます）。ここでは何も呼び出さないため関係ありませんが、このパックを拡張する際に使用しないでください。Datastore APIには影響しません。
• 上流の全文検索（datastore_search の q=）ではアクセント記号が区別されます。 資格停止テーブルにはアクセント付きの「González」が多数含まれていますが、アクセントなしの q=Gonzalez では結果が0件になることを、リアルタイムで確認済みです。idb_check_mdb_debarment は q= を一切使いません。小規模な資格停止テーブル全体（約1,300件）を取得し、NFD正規化、発音区別符号の除去、トークン部分文字列照合をクライアント側で行います。
• 公告テーブルの type には末尾の空白が一貫せず含まれています — SELECT DISTINCT "type" を実行すると、"AWARD"、"AWARD "、"AWARD " が別々の値として返されます。比較する前に必ず TRIM() を適用し、= ではなく前方一致の ILIKE で照合してください。
• datastore_search_sql はバインドパラメーターに対応していません — 補間する前に、すべての文字列引数で引用符をエスケープします（' → ''）。CKANのSQLエンドポイントは、読み取りレプリカに対する SELECT 文のみを受け付けます。
• idb-project-procurement-contract-awards-data の多くの行では、awarded_firm_name が "Not Available" と記録されています。これは個人コンサルタントの選定（contract_type: "Individual Consultants"）では仕様上の値であり、データの欠落ではありません。

クイックスタート

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

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

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

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

これは意図的なものであり、誤って多重化されているわけではありません。メタツールを使えば、このパックでは扱えない質問にも、カタログ全体を横断して振り分ける ask_pipeworx を通じて回答できます。そのため、2つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、振り分け機能の価値を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/idb_search_notices \
  -H 'Content-Type: application/json' \
  -d '{"country":"Peru","open_only":true,"limit":5}'

最初の呼び出しではアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/idb_search_notices を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

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

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

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

npx -y @pipeworx/mcp-idb

このサーバーは標準入力／標準出力経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx による振り分けはありません。

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Idb data" })

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

詳細

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

ライセンス

MIT