atlasprzetargow

Atlas Przetargów — MCP サーバー

ポーランドの公共調達データに対応した初の MCP サーバーです。 Claude Desktop、Cursor、Continue、Cline、または MCP 対応の AI クライアントから、80 万件以上のポーランドの公共調達案件（BZP + TED）、発注者／契約者のプロフィール、カテゴリ別統計を直接検索できます。

Atlas Przetargów を基盤としています。ポーランドの公共調達を検索・分析できるプラットフォームです。

---

これは何ですか？

Model Context Protocol (MCP) を使うと、AI アシスタントを外部のツールやデータに接続できます。このサーバーは Atlas Przetargów API をあらゆる MCP クライアントに公開し、AI アシスタントで次のことができるようになります。

• ポーランドの公共調達案件を検索：キーワード、CPV カテゴリ、場所、金額、締め切りで検索できます
• 案件の詳細情報を取得：発注者、CPV コード、推定金額、締め切り、任意の AI 生成要約を含みます
• あらゆる発注機関（zamawiający）のプロフィールを確認：NIP に基づき、どの事業者が最も頻繁に契約を獲得しているかも確認できます
• あらゆる契約者（wykonawca）のプロフィールを確認：NIP に基づき、どの発注者から契約を獲得しているかも確認できます
• 任意の CPV カテゴリの市場統計を分析：件数、中央値、平均提案数、平均締め切りを確認できます
• 調達件数を県や都市ごとに比較
• 90 以上のポーランド公共調達用語を収録した用語集にアクセス
• 調達案件の分析、発注者のデューデリジェンス、案件の発見に役立つガイド付きワークフロー（プロンプト）を使用

---

クイックスタート（Claude Desktop）

オプション A — npx 経由（推奨、インストール不要）

Claude Desktop の設定ファイルを編集します。

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

次を追加します。

{
  "mcpServers": {
    "atlas-przetargow": {
      "command": "npx",
      "args": ["-y", "@atlasprzetargow/mcp"]
    }
  }
}

Claude Desktop を再起動します。Atlas のツールがツールパネルに表示されます。

オプション B — グローバルインストール

npm install -g @atlasprzetargow/mcp

次に、claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "atlas-przetargow": {
      "command": "atlas-przetargow-mcp"
    }
  }
}

---

使用例（Claude Desktop）

「ワルシャワで、予算が 50 万～500 万 PLN の募集中の建設案件を検索し、上位 5 件を表示してください」

「NIP 5252248481 に対して buyer-due-diligence プロンプトを使ってください」 （→ 発注機関としてワルシャワ市のデューデリジェンスを実行します）

「昨年、ポーランドの IT 調達案件の中央値はいくらでしたか？」

「調達案件 2026/BZP 00202613 を調べ、主要な条件とリスクを分析してください」

「医療機器の CPV コードを調べて、募集中の案件を表示してください」

「GDDKiA（国家道路局）から最も頻繁に契約を獲得しているのは誰ですか？」

---

ツール

ツール	説明
search_tenders	条件（クエリ、CPV、都市、県、金額の範囲、日付、並べ替え）を指定して調達案件を検索します
get_tender	ID で調達案件の詳細情報を取得します。任意で AI による要約も取得できます
get_buyer	NIP に基づいて発注機関のプロフィールと、落札数上位の契約者を取得します
get_contractor	NIP に基づいて契約者のプロフィールと、契約獲得数上位の発注者を取得します
search_entities	名前で発注者／契約者を検索します（ほかのツールで使う NIP を返します）
get_category_stats	CPV カテゴリの集計統計（件数、中央値、平均提案数、平均締め切り）を取得します
get_province_stats	県または都市別の統計（発注者上位、CPV 上位）を取得します
search_cpv	ポーランド語のキーワードで CPV コードを検索します

リソース

URI	説明
atlas://glossary	ポーランドの公共調達用語を 90 以上収録した用語集の索引
atlas://glossary/{slug}	指定した用語の詳細な定義
atlas://knowledge	詳細なナレッジベース記事の索引
atlas://knowledge/{slug}	ナレッジベース記事の全文

プロンプト

プロンプト	説明
analyze-tender	入札公告の包括的な分析：範囲、金額、期限、リスク、推奨事項
buyer-due-diligence	発注機関のデューデリジェンス：購買プロファイル、請負業者ネットワーク、警告サイン
find-opportunities	CPV、地域、金額の条件に合う、募集中の入札案件を検索します

---

設定（環境変数）

すべて任意です。デフォルト値は安全です。

変数	デフォルト	説明
ATLAS_API_BASE	https://atlasprzetargow.pl	API のルートです。ステージング環境やセルフホストの Atlas で役立ちます
ATLAS_API_KEY	(なし)	任意の Atlas API キー（atlas_...）です。https://atlasprzetargow.pl/konto （「API」タブ）で生成できます。1 日あたりのリクエスト上限が増加します（匿名：IP ごとに 1 500 回／日、キー使用時：5 000 回／日）。また、X-Api-Key として送信されます。ドキュメント：https://atlasprzetargow.pl/dokumentacja-api
ATLAS_TIMEOUT_MS	20000	リクエストのタイムアウト
ATLAS_MAX_RETRIES	2	429／5xx／タイムアウト時の再試行回数

MCP クライアントの設定から渡します：

{
  "mcpServers": {
    "atlas-przetargow": {
      "command": "npx",
      "args": ["-y", "@atlasprzetargow/mcp"],
      "env": {
        "ATLAS_API_KEY": "atlas_your_key_here"
      }
    }
  }
}

---

ポーランドの公共調達 — クイックリファレンス

• BZP（Biuletyn Zamówień Publicznych）— ポーランドの全国入札登録簿です。ID の形式は 2026/BZP 00202613 です。
• TED（Tenders Electronic Daily）— EU 全域の入札登録簿です。EU の基準額を超える入札では必須です。
• CPV（Common Procurement Vocabulary）— 8 桁のカテゴリコードです。例：45000000 = 建設、72000000 = IT。
• NIP — ポーランドの 10 桁の納税者番号で、すべての発注者／請負業者の識別に使用されます。
• 県コード： PL02 dolnośląskie · PL04 kujawsko-pomorskie · PL06 lubelskie · PL08 lubuskie · PL10 łódzkie · PL12 małopolskie · PL14 mazowieckie · PL16 opolskie · PL18 podkarpackie · PL20 podlaskie · PL22 pomorskie · PL24 śląskie · PL26 świętokrzyskie · PL28 warmińsko-mazurskie · PL30 wielkopolskie · PL32 zachodniopomorskie
• 公告の種類：
  • ContractNotice — 入札受付中の案件
  • TenderResultNotice / ContractAwardNotice — 結果（落札者と落札価格）
  • CompetitionNotice、ConcessionNotice — 専門分野の公告

---

開発

git clone https://github.com/atlasprzetargow/mcp-server.git
cd mcp-server
npm install
npm run build
npm run smoke   # runs all tools against production API

# Test locally in Claude Desktop:
# Point the "command" in claude_desktop_config.json to the absolute path of dist/index.js:
# "command": "node", "args": ["/abs/path/to/mcp-server/dist/index.js"]

---

レート制限と適正利用

Atlas Przetargów API には IP ごとのレート制限があります（LLM エンドポイントは 30 リクエスト／分、公開エンドポイントはそれ以上）。MCP サーバーは指数バックオフを使用して、429 レスポンスを自動的に再試行します。

レート制限に頻繁に達する場合（本番環境での自動化など）は、上位プランの利用について atlasprzetargow.pl/kontakt からお問い合わせください。

---

ライセンス

MIT © Atlas Przetargów

データソースの帰属表示

すべての入札データの出典は次のとおりです：

• BZP（Biuletyn Zamówień Publicznych）— ポーランド公共調達局の公開登録簿
• TED（Tenders Electronic Daily）— EU の公共調達登録簿

Atlas Przetargów が処理、拡充し、提供しています。

---

関連リンク

• Atlas Przetargów — ウェブインターフェース
• Model Context Protocol — 標準規格
• Claude Desktop — 参考クライアント
• awesome-mcp-servers — コミュニティによる一覧