koko-call-mcp

KokoCallMCP

日本語

KokoCallMCP は、日本全国の官公需入札情報を Claude、Cursor、VS Code などのMCPクライアントから検索するための読み取り専用MCPサーバーです。

出典: 中小企業庁 官公需情報ポータルサイト 検索API。

特徴

• MCP 2025-11-25 の Tools、Prompts、Resources、Resource Templates、Completion、Logging に対応。
• search_bids、list_recent_bids、get_bid_detail、summarize_bids_by_org の4ツール。
• すべての構造化出力に attribution を含め、出典明記を強制。
• stdio と Streamable HTTP の両方に対応。

検索の使い分け

• query: 全文検索。複数キーワードや幅広い探索に使います。
• project_name: 件名だけを絞り込む場合に使います。
• organization_name: 発注機関名で探す場合に使います。
• prefecture: 都道府県で絞り込む場合に使います。
• 日付条件: issued_* は公告日、due_* は入札開始日、opening_* は開札日、period_end_* は納入期限日です。

起動

npm install
npm run build
npm start

Published package name:

npx koko-call-mcp

Check the CLI without starting an MCP session:

npx koko-call-mcp --help

HTTP:

npm run start:http

Streamable HTTP deployment is supported by the server, but the public MCP Registry metadata only advertises the stdio package until a live Cloud Run URL is deployed.

テスト

npm run check
npm run bench
npm run api:health
npm run build:repro
npm run release:gate
npm run publish:dry-run

関連ドキュメント

• docs/architecture.md
• docs/inspector.md
• docs/deployment-cloud-run.md
• docs/release.md
• docs/reproducible-builds.md
• docs/api-health-check.md
• docs/releases/v0.2.0.md
• docs/demo-script.md

English

KokoCallMCP is a read-only MCP server for searching Japan government procurement bid information from MCP clients such as Claude, Cursor, and VS Code.

Source: Small and Medium Enterprise Agency KKJ procurement search API.

Features

• Supports MCP 2025-11-25 Tools, Prompts, Resources, Resource Templates, Completion, and Logging.
• Four focused tools: search_bids, list_recent_bids, get_bid_detail, and summarize_bids_by_org.
• Every structured result includes required attribution.
• Supports both stdio and Streamable HTTP.
• Includes contract tests, property-based tests, benchmarks, mutation testing configuration, SBOM generation, CodeQL, and Dependency Review.
• The initial public Registry metadata advertises stdio only; remote Streamable HTTP metadata should be added after a live Cloud Run URL exists.

Search Guidance

• query: full-text search for broad discovery.
• project_name: project-title filtering.
• organization_name: buyer or issuing organization filtering.
• prefecture: prefecture filtering.
• Date filters: issued_* is notice date, due_* is tender submission date, opening_* is opening date, and period_end_* is delivery/end date.

Bahasa Indonesia

KokoCallMCP adalah server MCP read-only untuk mencari informasi tender pengadaan pemerintah Jepang dari klien MCP seperti Claude, Cursor, dan VS Code.

Sumber: API pencarian pengadaan KKJ dari Small and Medium Enterprise Agency.

Fitur

• Mendukung Tools, Prompts, Resources, Resource Templates, Completion, dan Logging dari MCP 2025-11-25.
• Empat tool terfokus: search_bids, list_recent_bids, get_bid_detail, dan summarize_bids_by_org.
• Setiap hasil terstruktur wajib menyertakan attribution.
• Mendukung stdio dan Streamable HTTP.
• Menyertakan contract test, property-based test, benchmark, konfigurasi mutation testing, SBOM, CodeQL, dan Dependency Review.
• Metadata Registry publik awal hanya mengiklankan stdio; metadata Streamable HTTP remote ditambahkan setelah URL Cloud Run live tersedia.

Panduan Pencarian

• query: pencarian full-text untuk eksplorasi luas.
• project_name: filter berdasarkan judul proyek.
• organization_name: filter berdasarkan instansi pembeli atau penerbit.
• prefecture: filter berdasarkan prefektur.
• Filter tanggal: issued_* untuk tanggal pengumuman, due_* untuk tanggal mulai tender, opening_* untuk tanggal pembukaan, dan period_end_* untuk tanggal akhir pengiriman.