Ihale MCP

🚀 招標MCP：面向土耳其公共招標的MCP服務器

本項目旨在創建一個 FastMCP 服務器，用於簡化對土耳其公共招標（ekap.kik.gov.tr）的訪問。通過該服務器，基於模型上下文協議（MCP）的大語言模型（LLM）應用程序（如 Claude Desktop 或 5ire）以及其他客戶端，能夠以工具形式實現從 EKAP v2 門戶搜索招標信息、獲取招標詳情以及以 Markdown 格式獲取招標公告等操作。

✨ 主要特性

• 標準化 MCP 接口：為 EKAP v2 門戶提供了用於程序訪問的標準 MCP 接口。
• 豐富的功能：
  • 詳細招標搜索：支持通過招標名稱/內容、IKN 編號、招標類型、省份、日期範圍以及 17 種以上布爾過濾器進行全面搜索。
  • 招標詳情獲取：可獲取特定招標的完整詳細信息，包括屬性、OKAS 代碼、管理信息和操作規則。
  • 招標公告獲取：自動將 HTML 格式轉換為 Markdown 格式，獲取與招標相關的所有公告，如預公告、招標公告、結果公告等。
  • OKAS 代碼搜索：支持在土耳其公共採購分類代碼中進行搜索。
  • 管理機構搜索：可搜索如部委、市政府、大學等公共機構。
• 格式轉換：將招標文本從 HTML 格式轉換為 Markdown 格式，便於大語言模型進行處理。
• 集成便捷：易於與 Claude Desktop 應用程序集成，同時也支持 5ire 等其他 MCP 客戶端。

📦 安裝指南

🚀 非 Claude 模型的簡易安裝（以 5ire 為例）

本部分適用於希望將招標 MCP 工具與 Claude Desktop 以外的 MCP 客戶端（如 5ire）配合使用的用戶。

1. 安裝 Python：系統需安裝 Python 3.11 或更高版本。安裝時請務必勾選“Add Python to PATH”（將 Python 添加到系統路徑）選項，可從 此處 下載。
2. 安裝 Git（Windows）：從 此處 下載並安裝 Git 軟件，建議選擇“Git for Windows/x64 Setup”選項。
3. 安裝 uv：
   • Windows 用戶（PowerShell）：打開 CMD 窗口，運行以下命令：

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

- **Mac/Linux 用戶（終端）**：打開終端窗口，運行以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

4. 安裝 Microsoft Visual C++ Redistributable（Windows）：部分 Python 包的正常運行依賴該組件，可從 此處 下載並安裝。
5. 安裝 5ire：根據操作系統下載並安裝 5ire MCP 客戶端。
6. 配置 5ire：打開 5ire 應用程序，在“Workspace -> Providers”菜單中輸入所需 LLM 服務的 API 密鑰。
7. 添加工具：進入“Tools”菜單，點擊“+Local”或“New”按鈕，進行如下配置：
   • Tool Key：ihalemcp
   • Name：招標 MCP
   • Command：

uvx --from git+https://github.com/saidsurucu/ihale-mcp ihale-mcp

點擊“Save”按鈕保存配置。

8. 啟用工具：此時應能在“Tools”菜單下看到“招標 MCP”工具，將鼠標懸停在該工具上，點擊右側出現的按鈕啟用（綠色指示燈應亮起）。
9. 開始使用：現在可以與招標 MCP 進行交互。

⚙️ Claude Desktop 手動安裝步驟

1. 確認依賴：確保系統已安裝 Python、uv 以及（Windows 用戶）Microsoft Visual C++ Redistributable。具體安裝步驟可參考上述“5ire 安裝”部分。
2. 編輯配置文件：打開 Claude Desktop，依次點擊“Settings -> Developer -> Edit Config”。
3. 添加配置信息：在打開的 claude_desktop_config.json 文件中，在 mcpServers 下添加以下內容：

{
    "mcpServers": {
        "招標 MCP": {
            "command": "uvx",
            "args": [
                "--from", "git+https://github.com/saidsurucu/ihale-mcp",
                "ihale-mcp"
            ]
        }
    }
}

4. 重啟應用程序：關閉並重新啟動 Claude Desktop。

💻 使用示例

🛠️ 可用工具（MCP 工具）

此 FastMCP 服務器為 LLM 模型提供了以下工具：

• search_tenders：在 EKAP v2 門戶上進行全面的招標搜索。
  • 主要參數：search_text、ikn_year、ikn_number、tender_types、tender_date_start/end、announcement_date_start/end
  • 布爾過濾器：e_ihale、ortak_alim_mi、kismi_teklif_mi、yabanci_isteklilere_izin_veriliyor_mu 等 13 種以上過濾器
  • 列表過濾器：provinces、tender_statuses、tender_methods、okas_codes、authority_ids、proposal_types、announcement_types
  • 搜索範圍：search_in_title、search_in_announcement、search_in_tech_spec 等 11 個不同字段
  • 返回值：分頁的招標列表及總結果數
• search_okas_codes：在 OKAS（公共採購分類）代碼中進行搜索。
  • 參數：search_term、kalem_turu（1 = 商品，2 = 服務，3 = 建設）、limit
  • 返回值：OKAS 代碼、說明及類別
• search_authorities：在土耳其公共機構中進行搜索。
  • 參數：search_term、limit
  • 返回值：機構 ID、名稱及層級信息
• get_recent_tenders：獲取最近 N 天內的招標信息。
  • 參數：days（1 - 30）、tender_types、limit
  • 返回值：近期招標列表
• get_tender_announcements：獲取特定招標的所有公告。
  • 參數：tender_id、include_html
  • 返回值：自動轉換為 Markdown 格式的招標公告
• get_tender_details：獲取特定招標的詳細信息。
  • 參數：tender_id
  • 返回值：招標屬性、OKAS 代碼、管理信息、操作規則以及自動轉換為 Markdown 格式的公告摘要

招標類型

• 1 - 商品：物資和設備採購
• 2 - 建設：建築和基礎設施項目
• 3 - 服務：服務合同
• 4 - 諮詢：諮詢服務

示例應用場景

1. 市場調研：跟蹤特定行業或地區的機會。
2. 合規監測：監控招標公告以確保符合法律法規。
3. 商業智能：分析公共支出模式和趨勢。
4. 通知系統：為特定招標類型設置提醒系統。
5. 數據分析：提取招標數據進行研究和分析。

新特性

• 17 種以上布爾過濾器：支持電子招標、聯合採購、部分報價、外國參與等過濾條件。
• 列表過濾器：支持按省份、招標狀態、方式、OKAS 代碼、管理機構 ID 等進行過濾。
• 搜索範圍控制：可在 IKN、標題、公告、技術規格等多個字段進行搜索。
• 管理機構搜索：支持在 72,000 多個公共機構（部委、市政府、大學等）中進行搜索。
• 招標公告處理：自動將 HTML 格式的公告轉換為 Markdown 格式，提供完整公告文本。
• 全面招標詳情：整合所有招標元數據、屬性和規則。

API 速率限制

本服務器遵循 EKAP 門戶的速率限制。在生產環境中使用時，請考慮以下幾點：

• 請求緩存：通過緩存請求減少 API 調用次數。
• 指數退避重試機制：採用指數退避策略進行重試。
• 請求隊列：對於高流量使用場景，使用請求隊列。

📄 許可證

本項目採用 MIT 許可證授權。詳細信息請參閱 LICENSE 文件。

免責聲明

本項目是與土耳其政府 EKAP 門戶的非官方集成。用戶有責任遵守該門戶的服務條款和適用法規。作者與土耳其政府或 EKAP 門戶無關聯。