Prozorro MCP Server

🚀 Prozorro MCP服務器

Prozorro MCP服務器是一個模型上下文協議（MCP）服務器，它能讓AI模型無縫訪問來自Prozorro（烏克蘭公共採購系統）的烏克蘭政府採購數據。

⚠️ 重要提示

要使用所有可用功能，需要有代理服務器和數據庫，因此目前MCP API不對外公開。如需獲取API URL和API令牌，請聯繫作者。

✨ 主要特性

• 🔍 招標搜索：可通過EDRPOU代碼、法定名稱或日期範圍進行高級搜索。
• ⚡ 快速響應：直接與Prozorro的公共採購數據庫進行API集成。
• 🛠️ 易於集成：可與Claude Desktop和其他MCP客戶端輕鬆設置集成。

📦 安裝指南

方法一：通過npm安裝（推薦）

通過npm安裝MCP服務器是最簡單的方法：

npm install -g prozorro-mcp-server

安裝完成後，將其添加到Claude Desktop配置中：

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prozorro": {
      "command": "prozorro-mcp-server",
      "env": {
        "PROZORRO_API_TOKEN": "your-api-token-here",
        "PROZORRO_SERVICE_URL": "mcp-api-url-here"
      }
    }
  }
}

重啟Claude Desktop，即可開始使用服務器！

💡 使用建議

在Linux/macOS系統中，若遇到權限問題，可能需要使用 sudo npm install -g prozorro-mcp-server 或配置npm使用用戶目錄。

方法二：從GitHub安裝

1. 通過npm從GitHub全局安裝：

npm install -g git+https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git

2. 添加到Claude Desktop配置中：

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

{
  "mcpServers": {
    "prozorro": {
      "command": "prozorro-mcp-server",
      "env": {
        "PROZORRO_API_TOKEN": "your-api-token-here",
        "PROZORRO_SERVICE_URL": "mcp-api-url-here"
      }
    }
  }
}

3. 重啟Claude Desktop：服務器即可使用！

方法三：本地開發安裝

1. 克隆倉庫：

git clone https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git
cd prozorro-mcp-server

2. 安裝依賴：

npm install

3. 構建項目：

npm run build

4. 添加到Claude Desktop配置中（使用絕對路徑）：

{
  "mcpServers": {
    "prozorro": {
      "command": "node",
      "args": ["/absolute/path/to/prozorro-mcp-server/build/index.js"],
      "env": {
        "PROZORRO_API_TOKEN": "your-api-token-here",
        "PROZORRO_SERVICE_URL": "https://prozorro.gov.ua"
      }
    }
  }
}

🔧 配置說明

服務器需要特定的環境變量才能正常運行。你可以在Claude Desktop配置中設置這些變量，或者在本地開發時在 .env 文件中設置。

獲取API憑證

要獲取Prozorro的API憑證和URL，請按以下步驟操作：

1. 聯繫作者。
2. 獲取API令牌和URL。
3. 在配置中使用該令牌和URL。

💻 使用示例

可用工具 - search_tenders

根據各種條件搜索政府招標信息（目前僅提供2025年的數據）。

參數：

• EDRPOUCode（字符串，可選）：組織的唯一標識符代碼（烏克蘭稅號）。
• legalName（字符串，可選）：用於匹配組織法定名稱的子字符串。
• dateFrom（字符串，可選）：搜索的開始日期（ISO 8601格式，例如 2025-01-01）。
• dateTo（字符串，可選）：搜索的結束日期（ISO 8601格式，例如 2025-12-31）。
• limit（數字，可選）：返回的最大記錄數（默認值：100，最大值：1000）。

返回值：包含詳細信息的招標對象數組，包括招標ID、標題、組織詳情、日期和採購狀態。

常見使用流程

流程一：按組織搜索招標

1. 使用 `search_tenders` 並傳入 `EDRPOUCode` 參數，查找特定組織的所有招標。
2. 查看返回的招標詳情，包括日期、金額和狀態。
3. 如有需要，按日期範圍過濾結果。

流程二：查找近期招標

1. 使用 `search_tenders` 並傳入 `dateFrom` 和 `dateTo` 參數。
2. 可選擇使用 `legalName` 按組織名稱過濾。
3. 限制結果數量以提高性能。

📚 詳細文檔

故障排除

服務器未在Claude Desktop中顯示

1. 檢查 claude_desktop_config.json 中的路徑是否正確。
2. 確保已使用 npm run build 構建項目。
3. 驗證是否安裝了Node.js（需要版本18或更高）。
4. 重啟Claude Desktop。
5. 檢查Claude Desktop日誌以查找錯誤信息。

API請求失敗

• 驗證 PROZORRO_API_TOKEN 是否有效且未過期。
• 檢查 PROZORRO_SERVICE_URL 是否正確。
• Prozorro API可能有速率限制，可考慮在請求之間添加延遲。
• 需要與prozorro.gov.ua建立網絡連接。
• 部分招標信息可能暫時不可用。

身份驗證錯誤

• 確保API令牌（如果需要）包含 Bearer 前綴。
• 檢查令牌是否具有必要的權限。
• 驗證令牌是否未過期。

開發說明

項目結構

prozorro-mcp-server/
├── src/
│   ├── index.ts              # 主MCP服務器入口點
│   ├── tenders.ts            # 招標搜索實現
│   └── types.ts              # TypeScript類型定義
├── build/                    # 編譯後的JavaScript（自動生成）
├── package.json
├── tsconfig.json
└── README.md

在開發模式下運行

# 監聽模式 - 文件更改時自動重建
npm run dev

# 在另一個終端中
npm start

生產環境構建

npm run build

API信息

此服務器使用Prozorro公共API來檢索招標信息。有關Prozorro系統和可用數據的更多詳細信息：

• Prozorro網站：https://prozorro.gov.ua/
• API文檔：https://prozorro.gov.ua/api
• 數據格式：包含詳細招標信息的JSON響應。

📄 許可證

ISC

貢獻說明

歡迎貢獻代碼！請隨時提交拉取請求。

聯繫我們

如有問題，請使用GitHub Issues頁面進行反饋。