MCP Mtender Server

🚀 MTender 數據服務器使用說明

MTender 數據服務器是一款 MCP 系統數據讀取器，可提供 Moldova 公共採購和合同信息。藉助它，用戶能夠通過 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。