Prozorro MCP Server

Сервер Model Context Protocol (MCP), який надає AI моделям безперешкодний доступ до даних про державні закупівлі України з системи Prozorro - публічної системи закупівель України.

Для надання всіх доступних функцій потрібен проксі-сервер та база даних, тому зараз MCP API не доступно публічно. Щоб отримати URL API та токен API, будь ласка, зв'яжіться з автором.

Можливості

• 🔍 Пошук тендерів: Розширені можливості пошуку за кодом ЄДРПОУ, юридичною назвою або діапазоном дат
• ⚡ Швидкість: Пряма інтеграція з API бази даних публічних закупівель Prozorro
• 🛠️ Легка інтеграція: Просте налаштування з Claude Desktop та іншими MCP клієнтами

Доступні інструменти

search_tenders

Пошук державних тендерів за різними критеріями (Наразі дані доступні тільки за 2025 рік).

Параметри:

• EDRPOUCode (рядок, необов'язково): Унікальний ідентифікаційний код організації (український податковий номер)
• legalName (рядок, необов'язково): Підрядок для пошуку в юридичній назві організації
• dateFrom (рядок, необов'язково): Початкова дата для пошуку (формат ISO 8601, наприклад, 2025-01-01)
• dateTo (рядок, необов'язково): Кінцева дата для пошуку (формат ISO 8601, наприклад, 2025-12-31)
• limit (число, необов'язково): Максимальна кількість записів для повернення (за замовчуванням: 100, максимум: 1000)

Повертає: Масив об'єктів тендерів з детальною інформацією, включаючи ID тендера, назву, деталі організації, дати та статус закупівлі.

Встановлення

Метод 1: Встановлення з npm (Рекомендовано)

Найпростіший спосіб встановити MCP сервер через npm:

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": "ваш-api-токен-тут",
        "PROZORRO_SERVICE_URL": "mcp-api-url-тут"
      }
    }
  }
}

Перезапустіть Claude Desktop і ви готові використовувати сервер!

Примітка: На Linux/macOS, якщо виникають проблеми з правами доступу, можливо, вам потрібно використати sudo npm install -g prozorro-mcp-server або налаштувати npm для використання користувацької директорії.

Метод 2: Встановлення з 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": "ваш-api-токен-тут",
        "PROZORRO_SERVICE_URL": "mcp-api-url-тут"
      }
    }
  }
}

3. Перезапустіть Claude Desktop - Сервер буде готовий до використання!

Метод 3: Локальне встановлення для розробки

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": ["/абсолютний/шлях/до/prozorro-mcp-server/build/index.js"],
      "env": {
        "PROZORRO_API_TOKEN": "ваш-api-токен-тут",
        "PROZORRO_SERVICE_URL": "https://prozorro.gov.ua"
      }
    }
  }
}

Конфігурація

Сервер вимагає певних змінних середовища для правильної роботи. Ви можете встановити їх у конфігурації Claude Desktop або у файлі .env для локальної розробки.

| Змінна | Опис | Обов'язкова | Приклад | |--------|------|:-----------:|---------| | PROZORRO_API_TOKEN | Ваш Bearer токен для Prozorro API | Так | Bearer abc123... | | PROZORRO_SERVICE_URL | Базова URL для API | Так | https://mcp-service-url.... |

Отримання облікових даних API

Щоб отримати облікові дані та URL для Prozorro:

1. Зв'яжіться з автором
2. Отримайте API токен та URL
3. Використовуйте токен та URL у вашій конфігурації

Типові робочі процеси

Робочий процес 1: Пошук тендерів за організацією

1. Використовуйте search_tenders з EDRPOUCode для пошуку всіх тендерів від конкретної організації
2. Перегляньте повернуті деталі тендера, включаючи дати, суми та статус
3. За потреби відфільтруйте результати за діапазоном дат

Робочий процес 2: Пошук останніх тендерів

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 правильний
• API Prozorro може мати обмеження швидкості - розгляньте можливість додавання затримок між запитами
• Потрібне мережеве підключення до 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

Цей сервер використовує публічний API Prozorro для отримання інформації про тендери. Для отримання додаткової інформації про систему Prozorro та доступні дані:

• Веб-сайт Prozorro: https://prozorro.gov.ua/
• Документація API: https://prozorro.gov.ua/api
• Формат даних: JSON відповіді з детальною інформацією про тендери

Ліцензія

ISC

Внесок

Внески вітаються! Будь ласка, не соромтеся надсилати Pull Request.

Контакти

Для питань та проблем, будь ласка, використовуйте сторінку GitHub Issues.