JP Bids MCP

官方

日本政府採購標案搜尋與AI分析(透過MCP)

你可以用 JP Bids MCP 做什麼?

  • 搜尋日本招標公告 — 使用 search_bids,依關鍵字、地區、類別和日期搜尋日本 47 個都道府縣的公告。
  • 列出近期公告 — 使用 list_recent_bids,列出過去 1–30 天內新發布的採購公告。
  • 查看公告詳情 — 使用簽署的 bid_ref 或 bid_key,透過 get_bid_detail 還原公告的完整詳細資訊和官方附件網址。
  • 評分與比較標案 — 使用 rank_bids,在搜尋或篩選模式下為公告評分(0–100),並標示為爭取/審查/略過。
  • 擷取需求 — 使用 extract_bid_requirements,從中繼資料整理資格條件、截止日期和附件網址。
  • 匯出候選清單 — 使用 export_bid_shortlist,依原有順序將已評分或選取的公告匯出為 16 欄 CSV 或 JSON。

文件

JP Bids MCP (v0.10.1)

npm version CI License: Apache 2.0 Smithery

透過您平常使用的 AI(Claude / ChatGPT),搜尋、比較日本政府採購招標資訊、確認官方 URL,並輸出 16 欄 CSV 的 MCP 伺服器(v0.10.1・完全免費・無需安裝・公開 7 項工具)。
透過 MCP 搜尋、比較、確認官方公告 URL,並將日本政府採購公告候選清單匯出為 16 欄 CSV/JSON(v0.10.1、完全免費、以讀取為主、7 項公開工具 + 互動式 AI Bid Workspace UI)。
透過 MCP 搜尋、比較、確認官方 URL,並將日本政府採購公告匯出為 16 欄 CSV/JSON(v0.10.1、完全免費、以讀取為主、7 項公開工具)。

日文指南 (README.ja.md) · 使用說明書 (USER_GUIDE.ja.md) · 印尼文指南 (README.id.md)

完全免費且唯讀 (public_mvp) / 完全免費・以讀取為主
全部 7 項 public_mvp 工具和互動式 AI Bid Workspace UI 均可免費使用,無需註冊、無需信用卡,也不會在執行期間呼叫 Stripe 計費功能(src/lib/billing.ts 和 stripe 套件僅為可選的本機 full_local 開發而保留在儲存庫中,且絕不會在 public_mvp 中註冊)。伺服器絕不會提交投標或寫入外部系統。


60 秒一鍵開始(免費 / 無需安裝)— 60 秒即可一鍵連線

無需編寫程式、執行終端機命令或在本機安裝。直接將 Claude 或 ChatGPT 連線至託管的 Streamable HTTP 端點:

https://mcp.bid-jp.com/mcp

1. 在 Claude 中連線(Claude.ai / Claude Desktop)— 3 個步驟

  1. 開啟 Claude,前往 Settings / Customize → Connectors(設定 → 連接器)。
  2. 點選 Add Custom Connector,輸入名稱 JP Bids 和 URL https://mcp.bid-jp.com/mcp。
  3. 在一鍵 OAuth 2.0 同意畫面上點選 Allow / 許可する(Dynamic Client Registration + PKCE S256 — 無需帳號或密碼)。

2. 在 ChatGPT 中連線(Apps / Connectors)— 3 個步驟

  1. 開啟 ChatGPT Settings → Apps / Connectors。
  2. 使用 OAuth 2.0 驗證方式新增 MCP Server URL https://mcp.bid-jp.com/mcp。
  3. 在同意畫面上點選一次 Allow / 許可する,即可啟用全部 7 項採購工具和內嵌的 AI Bid Workspace。

3. 可直接複製的提示詞(搜尋 → 比較 → 官方連結 → 16 欄 CSV)

將以下任一提示詞直接貼到 Claude 或 ChatGPT(支援日文或英文):

1. Search & Open Visual Workspace:
「東京都・役務で、件名に『システム』を含む入札公告を最大5件検索して、AI Bid Workspaceを表示してください。」
("Search up to 5 IT service tenders in Tokyo and open the AI Bid Workspace.")

2. Compare Selected Notices Without Hallucination:
「今の検索結果から選んだ案件を、『クラウド』『保守』を重視して比較・ランク付けしてください。別の案件へ入れ替えないでください。」
("Rank the selected notices prioritizing 'cloud' and 'maintenance' without substituting other bids.")

3. Inspect Official Notice URL & Requirements Checklist:
「最初の案件の詳細と公式公告URL、確認すべき参加資格・提出期限を整理してください。」
("Show full details, official notice URLs, and a requirement checklist for the top notice.")

4. Export Validated 16-Column CSV Shortlist:
「選んだ案件の順序を保ったまま、16列の検討用CSVに出力してください。」
("Export the selected bids in exact selection order as a 16-column CSV.")

4. 可選的一鍵 Claude Skill 上傳(searching-japanese-bids.zip)

讓 Claude 內建掌握日本都道府縣代碼、採購類別(物品 / 工事 / 役務)和簽署的 bid_ref 工作流程:

  1. 從 GitHub Releases 下載 searching-japanese-bids.zip(或將 skills/searching-japanese-bids/ 壓縮成 zip)。
  2. 在 Claude.ai → Settings → Features → Skills → Upload skill 中,選取 searching-japanese-bids.zip。

公開 MVP 工具(7 項免費工具 + AI Bid Workspace UI)

工具 / ツール角色 / 說明方案
search_bids依關鍵字、地區、類別(物品 / 工事 / 役務)和日期搜尋全部 47 個都道府縣的公告 / キーワード・地域・区分・期間検索公開 MVP(免費)
list_recent_bids列出過去 1–30 天內新發布的公告 / 直近1〜30日間の新着公告一覧公開 MVP(免費)
get_bid_detail透過簽署的 bid_ref 或 bid_key 還原完整公告詳細資訊及官方附件 URL / 案件詳細・公式リンク確認公開 MVP(免費)
rank_bids在搜尋或 bid_refs 選取模式中進行確定性的 0–100 適配度評分(pursue / review / skip)/ 適合度・優先度比較公開 MVP(免費)
extract_bid_requirements根據中繼資料整理資格條件、截止日期和附件 URL(預設關閉外部內文擷取)/ 要件・確認資料URL整理公開 MVP(免費)
export_bid_shortlist將排名或選取的公告(保留原有順序)匯出為 16 欄 CSV 或 JSON / 16列CSV・JSON出力公開 MVP(免費)
search_bids_app互動式 MCP Apps 工作區(ui://jp-bids/search-results.html),提供 3 層 CSV/JSON 匯出備援 / 對話型搜尋工作區畫面公開 MVP(免費)

價格 / 料金 / 價格

方案價格內容
公開 MVP(v0.10.1)免費 / 無料 / 免費全部 7 項公開工具 + 單檔 MCP Apps UI(AI Bid Workspace)。無訂閱費用,也不會在執行期間呼叫計費功能。

(不包含第三方 AI 用戶端訂閱費用或自行託管的雲端費用 / 不含外部 AI 用戶端使用費或自行託管時的雲端費用)。

資源

  • attribution://kkj — KKJ 官方資料來源標示
  • docs://api-reference — 參數與結構描述參考
  • codes://prefectures — 日本 47 個都道府縣名稱與 lg_code 表格
  • ui://jp-bids/search-results.html — 單檔 MCP Apps UI 套件(connectDomains: []、resourceDomains: [])
  • prefecture://{lg_code} — 都道府縣中繼資料範本(01 – 47)

互通性 / 相互運用 / 互通性

JP Bids MCP 可與 J-Grants MCP(日本數位廳)無縫搭配,在同一段對話中搜尋政府採購合約和中小企業補助金:

"鹿児島県のITシステム調達案件と、中小企業向けDX補助金を同時に探してください。"

JP Bids MCP、J-Grants MCP 和 freee MCP 是由不同組織營運的獨立伺服器。


開發者 / 本機設定(stdio、CLI、full_local 與離線驗收)

Remote MCP:             https://mcp.bid-jp.com/mcp
Candidate version:      0.10.1 (currently published npm package: jp-bids-mcp@0.10.0)
Registry metadata name: io.github.sugukurukabe/jp-bids

託管的 /mcp 端點需要 OAuth 2.0(未經驗證的請求會收到 401,其中包含 WWW-Authenticate 資源中繼資料,以自動探索 DCR + PKCE S256)。純 curl 需要 Bearer token;若要在本機免驗證使用,請使用下方的 stdio。

1. 本機 npx Stdio 與 CLI 匯出(無需驗證)

# Start MCP server over stdio (defaults to public_mvp 7 tools)
npx --yes jp-bids-mcp

# Check version without starting a session
npx --yes jp-bids-mcp --version

# Direct CLI CSV export
npx --yes jp-bids-export --prefecture 鹿児島県 --category 役務 --query システム --days 7 > bids.csv

# Inspect Streamable HTTP or stdio with MCP Inspector
npx --yes @modelcontextprotocol/inspector

claude_desktop_config.json(透過 stdio 發布的 npm 套件):

{
  "mcpServers": {
    "jp-bids": {
      "command": "npx",
      "args": ["-y", "jp-bids-mcp"],
      "env": {
        "JP_BIDS_PROFILE": "public_mvp"
      }
    }
  }
}

2. 從原始碼建置與可選的 full_local 開發者方案

git clone https://github.com/sugukurukabe/koko-call-mcp.git
cd koko-call-mcp
npm install
npm run check
  • 標準本機執行環境(node dist/server.js):強制執行 TokenBucketRateLimiter(<= 1 req/sec)、不保存附件,且僅記錄 stderr。
  • 擴充本機方案(JP_BIDS_PROFILE=full_local):自行託管的本機方案,可解鎖另外 15 項參考工具(共 22 項),包括 ICS 行事曆匯出、內部審查資料包、問題草稿、已儲存的搜尋,以及 Investor Radar 股票代碼對應(docs/investor-radar.md;不構成投資建議)。

3. 離線模擬示範(M1–M3-B)與 Gate 1 驗收執行器

若要在完全不連線 KKJ 網路的情況下測試 UI 呈現和全部 35 項 Gate 1 驗收子條件(正式環境中的 Claude 與 ChatGPT 驗證紀錄請參閱 docs/VERIFICATION_STATUS.md):

{
  "mcpServers": {
    "jp-bids-mock": {
      "command": "node",
      "args": ["/path/to/koko-call-mcp/examples/mock-stdio-server.mjs"]
    }
  }
}
# Run Gate 1 acceptance suite under the loopback-only network guard (35/35 conditions, 0 external calls)
node --import ./evidence/q02_batch2/net-guard.batch2.path-null-fix.mjs tests/acceptance/gate1-runner.mjs

4. 通訊協定與登錄檔規格(v0.10.1)

  • MCP 2025-11-25 與無狀態 2026-07-28 HTTP 配接器:在 src/transports/http.ts 中執行 @modelcontextprotocol/sdk@1.32.2(原生 2025-11-25),並使用無狀態的 2026-07-28 HTTP 邊界配接器,強制執行 _meta["io.modelcontextprotocol/protocolVersion"]、Mcp-Method、依方法區分的 Mcp-Name(params.name 適用於 tools/call / prompts/get,params.uri 適用於 resources/read)、Cache-Control: no-store,以及 RFC 9207 iss(docs/spec-notes/mcp-2026-07-28.md)。
  • 官方 MCP Registry(server.json):符合 2025-12-11/server.schema.json(io.github.sugukurukabe/jp-bids)。
  • Server Card 探索(public/.well-known/mcp/server-card.json):公開全部 7 項 public_mvp 工具的完整 JSON 結構描述和 _meta.ui 綁定。

文件

注意事項與政策 / 注意事項

資料來源:中小企業廳 KKJ Portal Search API(中小企業庁 官公需情報ポータルサイト)。由 Sugukuru Inc. 提供(非官方政府機關產品)。本伺服器絕不儲存上游附件 PDF;投標前請務必向發標機關確認原始採購文件。