Ihale MCP

🚀 入札MCP：トルコ公共入札用のMCPサーバー

このプロジェクトは、トルコの公共入札（ekap.kik.gov.tr）へのアクセスを容易にするFastMCPサーバーを構築します。これにより、EKAP v2ポータルからの入札検索、入札詳細の取得、入札公告のMarkdown形式での取得といった操作が、Model Context Protocol (MCP)をサポートするLLM（大規模言語モデル）アプリケーション（例：Claude Desktopや5ire）やその他のクライアントによってツールとして利用可能になります。

✨ 主な機能

• EKAP v2ポータルへのプログラムによるアクセスのための標準的なMCPインターフェース。
• 以下の機能を備えています：
  • 詳細な入札検索：入札名/内容、IKN番号、入札種類、州、日付範囲、および17以上のブールフィルターを使用した包括的な検索。
  • 入札詳細：特定の入札の完全な詳細（特性、OKASコード、行政情報、取引規則）を取得。
  • 入札公告：入札に関するすべての公告（事前公告、入札公告、結果公告など）を自動的なHTMLからMarkdownへの変換で取得。
  • OKASコード検索：トルコの公共調達分類コードで検索を行う。
  • 行政検索：省庁、市役所、大学などの公共機関を検索。
• 入札テキストをHTMLからMarkdown形式に変換し、LLMによる処理を容易にする。
• Claude Desktopアプリケーションとの簡単な統合。
• 入札MCPは、Claude Desktop以外の5ireなどのMCPクライアントもサポートします。

📦 インストール

🚀 Claude以外のモデルでの使用のための簡単なインストール（例：5ire用）

このセクションは、入札MCPツールをClaude Desktop以外のMCPクライアント（例：5ire）で使用する場合のインストール手順です。

• Pythonのインストール：システムにPython 3.11以上がインストールされている必要があります。インストール時に「Add Python to PATH」（PythonをPATHに追加）を選択してください。こちらからダウンロードできます。
• Gitのインストール（Windows）：コンピューターにgitをダウンロードしてインストールします。「Git for Windows/x64 Setup」を選択してダウンロードしてください。
• 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
• Microsoft Visual C++ Redistributable（Windows）：一部のPythonパッケージを正常に動作させるために必要です。こちらからダウンロードしてインストールしてください。
• システムに合った5ire MCPクライアントをダウンロードしてインストールします。
• 5ireを開き、Workspace -> Providersメニューから使用するLLMサービスのAPIキーを入力します。
• Toolsメニューに移動し、+LocalまたはNewボタンをクリックします。
  • Tool Key：ihalemcp
  • Name：入札MCP
  • Command：

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

* **Save**ボタンをクリックして保存します。

• これで、Toolsの下に入札MCPが表示されるはずです。マウスを重ねて右側に表示されるボタンをクリックして有効にします（緑色のライトが点灯するはずです）。
• これで入札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を閉じて再起動します。

💻 使用例

主な使用シーン

1. 市場調査：特定のセクターや地域の機会を追跡する。
2. 適合性監視：法令遵守のために入札公告を監視する。
3. ビジネスインテリジェンス：公共支出モデルとトレンドを分析する。
4. 通知システム：特定の入札種類に対するアラートシステムを設定する。
5. データ分析：研究と分析のために入札データを抽出する。

📚 詳細ドキュメント

🛠️ 使用可能なツール（MCP Tools）

このFastMCPサーバーは、LLMモデルに以下のツールを提供します：

入札種類

• 1 - 物品：物品と設備の調達
• 2 - 建設：建設とインフラプロジェクト
• 3 - サービス：サービス契約
• 4 - コンサルティング：コンサルティングサービス

🔧 技術詳細

新機能

✅ 17以上のブールフィルター：e-入札、共同調達、部分入札、外国参画など。 ✅ リストフィルター：州、入札状態、方法、OKASコード、行政ID。 ✅ 検索範囲の制御：IKN、タイトル、公告、技術仕様書などのフィールドでの検索。 ✅ 行政検索：72,000以上の公共機関（省庁、市役所、大学）での検索。 ✅ 入札公告：自動的なHTMLからMarkdownへの変換による完全な公告テキスト。 ✅ 包括的な入札詳細：すべての入札メタデータ、特性、規則がまとめられています。

APIの速度制限

このサーバーはEKAPポータルの速度制限を考慮しています。本番環境での使用には以下の点を考慮してください：

• 要求のキャッシュを使用してAPI呼び出しを減らす。
• 指数関数的なバックオフによる再試行ロジックを使用する。
• 大量の使用の場合は要求キューを使用する。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

⚠️ 重要提示

これはトルコ政府のEKAPポータルとの非公式な統合です。ユーザーはポータルのサービス利用規約と適用される規制に準拠する責任があります。著者はトルコ政府またはEKAPポータルと関連していません。