MCP Mtender Server

🚀 MTender データサーバー使用説明

MTender データサーバーは、Moldova の公共調達と契約情報を提供する MCP システムのデータリーダーです。URI またはツールインターフェイスを通じて、構造化された OCDS（オープン契約データ標準）データにアクセスすることができます。

🚀 クイックスタート

MTender データサーバーを使用するには、以下の手順に従ってください。

1. Node.js と npm をダウンロードしてインストールします。
2. この GitHub リポジトリをクローンします：https://github.com/yoda-digital/mcp-mtender-server
3. プロジェクトのルートディレクトリで、コマンド npm install を実行して依存関係をインストールします。
4. ターミナルで npm start を実行してサーバーを起動します。デフォルトのポートは 3000 です。

✨ 主な機能

リソース URI

• mtender://latest-tenders：最新の入札公告を一覧表示します。
• mtender://tender/{ocid}：OCID を使用して入札の詳細情報を取得します。
• mtender://budget/{ocid}：OCID を使用して予算情報を取得します。
• mtender://funding/{ocid}：OCID を使用して資金源情報を取得します。

ツールインターフェイス

サーバーは以下のツールインターフェイスを提供しています。

1. search_tenders：入札公告を検索します。
   • ページング、日付範囲でのフィルタリングなどの高度な機能をサポートしています。
2. get_tender：単一の入札の詳細情報を取得します。
   • 出力形式を選択できます：完全なデータまたは簡潔な要約。
3. get_budget：予算の詳細を照会します。
4. get_funding_source：資金源情報を表示します。
5. analyze_tender：入札文書の指定された部分（計画、入札、入札結果など）を分析します。
6. fetch_tender_document：指定された入札文書の URL をダウンロードして解析します。

📚 ドキュメント

ツールパラメータの説明

search_tenders

• offset（オプション）：ページングのオフセット（ISO 日付文字列）
• limit（オプション）：結果の最大数
• dateFrom（オプション）：開始日（ISO 日付文字列）
• dateTo（オプション）：終了日（ISO 日付文字列）

get_tender

• ocid（必須）：OCID の値
• format（オプション）：出力形式。"full" と "summary" をサポートしています。

get_budget

• ocid（必須）：OCID の値
• format（オプション）：出力形式。"full" と "summary" をサポートしています。

get_funding_source

• ocid（必須）：OCID の値
• format（オプション）：出力形式。"full" と "summary" をサポートしています。

analyze_tender

• ocid（必須）：OCID の値
• sections（オプション）：分析する部分を指定します。例："plan"、"tender"、"award"

fetch_tender_document

• url（必須）：完全な入札文書の URL
• 戻り値：解析された文書の内容またはエラーメッセージ

サンプルクエリ

最新の入札公告を取得する

curl http://localhost:3000/mtender/latest-tenders

特定の日付範囲の入札を検索する

curl "http://localhost:3000/mtender/search_tenders?dateFrom=2023-01-01&dateTo=2023-12-31"

ログ記録

サーバーはデフォルトでログ記録機能が有効になっており、すべてのリクエストとレスポンスは logs/ ディレクトリ下のファイルに記録されます。ログ形式は標準の JSON 形式で、後の分析が容易です。

既知の制限

1. データ遅延：MTender データには一定の更新遅延があります（通常は 30 分）。
2. 最大同時接続数：サーバーはデフォルトで 50 個の同時リクエストをサポートしており、超えるとキューに入れられて処理されます。
3. ファイルサイズ制限：単一の入札文書の最大解析サイズは 10MB です。

API リファレンス

リソースインターフェイス

最新の入札公告

GET /mtender/latest-tenders

レスポンスの例：

[
    {
        "ocid": "MD-234567",
        "title": "公共道路維修プロジェクト",
        "date": "2023-10-01"
    },
    ...
]

単一の入札の詳細

GET /mtender/tender/{ocid}

レスポンスの例：

{
    "ocid": "MD-234567",
    "title": "公共道路維修プロジェクト",
    "description": "County Balti の主要な道路を修復する",
    "date": "2023-10-01"
}

ツールインターフェイス

入札を検索する

POST /mtender/search_tenders
{
    "query": {
        "offset": 0,
        "limit": 10,
        "dateFrom": "2023-01-01",
        "dateTo": "2023-12-31"
    }
}

📄 ライセンス

著作権表示

MTender データサーバーの著作権は Yoda Digital に帰属し、ソースコードは MIT ライセンスに従います。

使用条件

個人および非商用目的での使用のみが許可されています。許可なく二次開発または商用利用することは禁止されています。

貢献ガイド

GitHub を通じて問題の報告やプルリクエストを歓迎します：https://github.com/yoda-digital/mcp-mtender-server

さらなるサポートが必要な場合は、support@yodalabs.md までご連絡ください。