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)
透過您平常使用的 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 個步驟
- 開啟 Claude,前往 Settings / Customize → Connectors(設定 → 連接器)。
- 點選 Add Custom Connector,輸入名稱
JP Bids和 URLhttps://mcp.bid-jp.com/mcp。 - 在一鍵 OAuth 2.0 同意畫面上點選 Allow / 許可する(Dynamic Client Registration + PKCE S256 — 無需帳號或密碼)。
2. 在 ChatGPT 中連線(Apps / Connectors)— 3 個步驟
- 開啟 ChatGPT Settings → Apps / Connectors。
- 使用 OAuth 2.0 驗證方式新增 MCP Server URL
https://mcp.bid-jp.com/mcp。 - 在同意畫面上點選一次 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 工作流程:
- 從 GitHub Releases 下載
searching-japanese-bids.zip(或將skills/searching-japanese-bids/壓縮成 zip)。 - 在 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補助金を同時に探してください。"
- 設定與工作流程範例:examples/jgrants-integration/ · docs/integrations/jgrants.md
- 與 freee MCP 的會計交接:examples/freee-integration/
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-28HTTP 配接器:在src/transports/http.ts中執行@modelcontextprotocol/sdk@1.32.2(原生2025-11-25),並使用無狀態的2026-07-28HTTP 邊界配接器,強制執行_meta["io.modelcontextprotocol/protocolVersion"]、Mcp-Method、依方法區分的Mcp-Name(params.name適用於tools/call/prompts/get,params.uri適用於resources/read)、Cache-Control: no-store,以及 RFC 9207iss(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綁定。
文件
- 使用者指南(日文) · 功能規格 · 驗證狀態
- 上線操作手冊 · 遠端發布檢查清單 · 目錄提交
- 架構 · MCP Apps UI · AI Bid Radar · Cloud Run 部署 · ADR
注意事項與政策 / 注意事項
資料來源:中小企業廳 KKJ Portal Search API(中小企業庁 官公需情報ポータルサイト)。由 Sugukuru Inc. 提供(非官方政府機關產品)。本伺服器絕不儲存上游附件 PDF;投標前請務必向發標機關確認原始採購文件。