Prozorro MCP Server

🚀 Prozorro MCP Server

このModel Context Protocol (MCP)サーバーは、Ukraineの公共調達システムであるProzorroからのUkraine政府調達データに、AIモデルがシームレスにアクセスできるようにします。

⚠️ 重要提示

すべての利用可能な機能を提供するには、プロキシサーバーとデータベースが必要です。現在、MCP APIは公開されていません。API URLとAPIトークンを取得するには、作者にお問い合わせください。

✨ 主な機能

• 🔍 入札の検索: EDRPOUコード、法人名、または日付範囲による高度な検索機能
• ⚡ 高速: Prozorroの公共調達データベースとの直接API統合
• 🛠️ 簡単な統合: Claude Desktopやその他のMCPクライアントでの簡単なセットアップ

🛠️ 利用可能なツール

search_tenders

様々な条件に基づいて政府入札を検索します（現在、データは2025年分のみ利用可能です）。

パラメーター:

• EDRPOUCode (文字列、オプション): 組織の一意の識別コード（Ukraineの税務ID）
• 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": "your-api-token-here",
        "PROZORRO_SERVICE_URL": "mcp-api-url-here"
      }
    }
  }
}

Claude Desktopを再起動すると、サーバーを使用できるようになります！

💡 使用建议

Linux/macOSでパーミッションの問題が発生した場合は、sudo npm install -g prozorro-mcp-serverを使用するか、npmがユーザーディレクトリを使用するように設定する必要があります。

方法2: GitHubからインストール

1. GitHubからnpmを介してグローバルにインストール:

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を再起動 - サーバーが使用可能になります！

方法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": ["/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を使用します

💻 使用例

ワークフロー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が正しいことを確認します
• 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

📚 ドキュメント

このサーバーは、Prozorroの公開APIを使用して入札情報を取得します。Prozorroシステムと利用可能なデータの詳細については:

• Prozorroのウェブサイト: https://prozorro.gov.ua/
• APIドキュメント: https://prozorro.gov.ua/api
• データ形式: 詳細な入札情報を含むJSONレスポンス

📄 ライセンス

ISC

🤝 コントリビューション

コントリビューションは大歓迎です！ご自由にプルリクエストを送信してください。

📞 連絡先

問題や質問がある場合は、GitHub Issuesページを使用してください。