atlasprzetargow

Atlas Przetargów — MCP 服务

首个专为波兰公共采购数据打造的 MCP 服务。 可直接从 Claude Desktop、Cursor、Continue、Cline 或任何兼容 MCP 的 AI 客户端，查询 800 000 多条波兰公共招标信息（BZP + TED）、采购方／承包商档案和类别统计数据。

由 Atlas Przetargów 提供支持——波兰公共采购搜索与分析平台。

---

这是什么？

模型上下文协议（MCP）让 AI 助手能够连接外部工具和数据。此服务将 Atlas Przetargów API 提供给任何 MCP 客户端，让你的 AI 助手能够：

• 搜索波兰公共招标，可按关键词、CPV 类别、地点、金额或截止日期筛选
• 获取完整招标详情，包括采购方、CPV 代码、预估金额、截止日期和可选的 AI 生成摘要
• 按 NIP 查看任意采购实体（zamawiający）的档案，包括最常赢得其合同的对象
• 按 NIP 查看任意承包商（wykonawca）的档案，包括他们从哪些采购方赢得合同
• 分析任意 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 中）

“查找华沙仍在进行的建筑招标，预算为 500k–5M PLN，并列出排名前 5 的项目”

“使用针对 NIP 5252248481 的采购方尽职调查提示词” （→ 对华沙市作为采购实体开展尽职调查）

“波兰去年 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	(none)	可选的 Atlas API 密钥（atlas_...），可在 https://atlasprzetargow.pl/konto 生成（“API”选项卡）。提高每日请求配额（匿名：每个 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）— 欧盟范围的招标登记处，超过欧盟门槛的招标必须在此登记。
• CPV（Common Procurement Vocabulary）— 8 位类别代码，例如 45000000 = 建筑工程，72000000 = IT。
• NIP — 波兰 10 位税号，用于识别每个采购方 / 承包商。
• 省份代码： PL02 下西里西亚 · PL04 库亚维-波美拉尼亚 · PL06 卢布林 · PL08 卢布斯卡 · PL10 罗兹 · PL12 小波兰 · PL14 马佐夫舍 · PL16 奥波莱 · PL18 喀尔巴阡山 · PL20 波德拉谢 · PL22 滨海 · PL24 西里西亚 · PL26 圣十字 · PL28 瓦尔米亚-马祖里 · PL30 大波兰 · PL32 西波美拉尼亚
• 公告类型：
  • 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）— 欧盟公共采购登记处

由 Atlas Przetargów 处理、丰富并提供。

---

相关链接

• Atlas Przetargów — 网页界面
• Model Context Protocol — 标准
• Claude Desktop — 参考客户端
• awesome-mcp-servers — 社区列表