procurement-notices-mcp

官公需情報ポータルで、国や自治体などの入札公告を探せます。発注機関や期間で絞り込んで、原文リンクや公告本文の抜粋を確認できます。

uv と Git が必要です。Python 3.12以上に対応しています。APIキーは不要です。

MCPクライアントに登録する

Codex

codex mcp add procurement-notices-mcp -- uvx --python 3.12 --from git+https://github.com/koizumikento/procurement-notices-mcp.git@main procurement-notices-mcp
codex mcp list

新しいセッションで /mcp を開いて接続を確認できます。デスクトップ版ではMCP設定画面で、下のJSON例と同じコマンド・引数を指定できます。

Claude Desktop / Cursor

• Claude Desktop（Windows） %APPDATA%/Claude/claude_desktop_config.json

• Claude Desktop（macOS） ~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor .cursor/mcp.json（プロジェクト内）

設定ファイルの mcpServers に項目を追加して、クライアントを再起動してください。uvx が見つからない場合は実行ファイルの絶対パスを指定します。

{
  "mcpServers": {
    "procurement-notices-mcp": {
      "command": "uvx",
      "args": [
        "--python",
        "3.12",
        "--from",
        "git+https://github.com/koizumikento/procurement-notices-mcp.git@main",
        "procurement-notices-mcp"
      ]
    }
  }
}

防災に関する東京都の入札公告を探して、発注機関と原文を教えて。

Related MCP server: kanpou-mcp

MCPツール

search_notices

次の検索条件のうち、キーワード・件名・発注機関・都道府県のいずれか1つ以上を指定します。limit は返す件数で、1〜50件です（既定10件）。

期間には単日 2026-04-01、両端を含む期間 2026-04-01/2026-04-30、開始日以降 2026-04-01/、終了日以前 /2026-04-30 を指定できます。条件はポータル側で適用します。データが未整備の項目もあるため、日付や資格などの条件を追加すると、該当項目が空欄の公告が検索から外れる場合があります。

include_details=true にすると、1件ごとに公告本文の先頭2,000文字と、ポータルに収録された添付リンクを先頭10件まで返します。省略した場合は body_truncated または attachments_truncated が true になります。元の公告や添付ファイルは取得しません。

published_at はポータルの公告日で、公告日が分からない場合は取得日です。collected_at はポータルが取得した日時です。tender_start_at は入札開始日です。申請の締切や参加条件は公告原文で確認してください。

CLIで使う

uvx --python 3.12 --from git+https://github.com/koizumikento/procurement-notices-mcp.git@main procurement-notices-mcp search-notices --query 防災 --prefecture-code 13 --limit 3
uvx --python 3.12 --from git+https://github.com/koizumikento/procurement-notices-mcp.git@main procurement-notices-mcp search-notices --organization-name 法務省 --issue-period 2026-04-01/2026-04-30 --procedure-type 1 --include-details --limit 3

結果は標準出力にUTF-8のJSONで返ります。

Pythonから呼び出す

git clone https://github.com/koizumikento/procurement-notices-mcp.git
cd procurement-notices-mcp
uv sync --locked

import asyncio

from procurement_notices_mcp import search_notices

print(asyncio.run(search_notices(
    "防災", prefecture_code="13", issue_period="2026-04-01/", limit=3
)))

既にイベントループがある場合は関数を直接 await してください。

出典と利用条件

コードはMIT Licenseです。中小企業庁の官公需情報ポータルサイト検索APIを利用しています。公式仕様・提供元と利用規約

開発

uv sync --locked
uv run ruff check .
uv run ty check
uv run pytest
uv build