kanpou-mcp
Enables n8n workflows to search and retrieve procurement notices from the Kanpo API via HTTP endpoints.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kanpou-mcp Find recent IT procurement notices from Tokyo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
官報API MCPサーバー
官公需情報ポータルサイトAPI(官報API)をLLMやAIエージェントがツールとして使用できるようにするMCP(Model Context Protocol)サーバーです。
機能
このMCPサーバーは以下のツールを提供します:
search_procurements - 詳細な検索条件で入札情報を検索
get_procurements_by_date - 指定した日付の入札情報を取得
search_by_keyword - キーワードで入札情報を検索
Related MCP server: koko-call-mcp
インストール
cd mcp-kanpo-api
npm install
npm run build使用方法
MCPクライアントでの設定
MCPクライアント(例: Claude Desktop、Cursor等)の設定ファイルに以下を追加してください:
Claude Desktopの場合 (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"kanpo-api": {
"command": "node",
"args": ["/path/to/mcp-kanpo-api/dist/index.js"]
}
}
}Cursorの場合 (.cursor/mcp.json または設定ファイル):
{
"mcpServers": {
"kanpo-api": {
"command": "node",
"args": ["/path/to/mcp-kanpo-api/dist/index.js"]
}
}
}開発モード
開発中は tsx を使用して直接実行できます:
npm run dev # stdio版
npm run dev:http # HTTP版HTTPサーバー版の使用方法
n8nなどのHTTPクライアントから使用する場合は、HTTPサーバー版を起動します:
npm run start:httpデフォルトで http://localhost:3000 で起動します。ポート番号は環境変数 PORT で変更できます:
PORT=8080 npm run start:http利用可能なエンドポイント
GET /- ヘルスチェックGET /api/tools- 利用可能なツール一覧POST /api/tools/search_procurements- 入札情報検索POST /api/tools/get_procurements_by_date- 日付指定取得POST /api/tools/search_by_keyword- キーワード検索
使用例
# 日付指定で取得
curl -X POST http://localhost:3000/api/tools/get_procurements_by_date \
-H "Content-Type: application/json" \
-d '{"date": "2025-11-07", "count": 50}'
# キーワード検索
curl -X POST http://localhost:3000/api/tools/search_by_keyword \
-H "Content-Type: application/json" \
-d '{"keyword": "情報システム", "count": 20}'ngrokでの公開
ngrokを使用してHTTPサーバーを外部公開できます:
# 1. HTTPサーバーを起動
npm run start:http
# 2. 別のターミナルでngrokを起動
ngrok http 3000
# 3. ngrokが提供するURL(例: https://xxxx-xxxx-xxxx.ngrok-free.app)をn8nで使用自然言語での使用方法
このMCPサーバーは、LLM/AIエージェント(Claude、GPT-4等)が自然言語の命令を理解して、適切なツールを自動的に呼び出すことを想定しています。
使用例:
「2025年11月7日の入札情報を取得して」→
get_procurements_by_dateツールが自動的に呼び出されます「情報システムというキーワードで検索して」→
search_by_keywordツールが自動的に呼び出されます「東京都の物品カテゴリーの入札情報を検索して」→
search_procurementsツールが自動的に呼び出されます「11月の役務カテゴリーの入札情報を検索して」→
search_procurementsツールが自動的に呼び出されます
LLM/AIエージェントは、あなたの自然言語の命令を理解し、適切なツールとパラメータを選択して実行します。
利用可能なツール
1. search_procurements
詳細な検索条件で入札情報を検索します。
パラメータ:
query(string, 任意): 検索文字列(AND、OR、NOT演算子使用可能)projectName(string, 任意): 件名で絞り込みorganizationName(string, 任意): 機関名で絞り込みlgCode(string, 任意): 都道府県コード(JIS X0401準拠)category(number, 任意): カテゴリー(1=物品, 2=工事, 3=役務)procedureType(number, 任意): 公示種別(1=一般競争入札, 2=簡易公募型競争入札, 3=簡易公募型指名競争入札)certification(string, 任意): 入札資格(A, B, C, D)cftIssueDate(string, 任意): 公告日(形式: YYYY-MM-DD/ または /YYYY-MM-DD または YYYY-MM-DD/YYYY-MM-DD)tenderSubmissionDeadline(string, 任意): 入札開始日openingTendersEvent(string, 任意): 開札日periodEndTime(string, 任意): 納入期限日count(number, 任意): 返却件数(デフォルト: 100、最大: 1000)
注意: query、projectName、organizationName、lgCodeのいずれか一つを指定することを推奨します。すべてが指定されない場合は、デフォルトでQuery="*"が使用されます。
2. get_procurements_by_date
指定した日付の入札情報を取得します。内部ではquery="入札"とcftIssueDateを指定して検索を実行します。
パラメータ:
date(string, 必須): 日付(形式: YYYY-MM-DD)count(number, 任意): 返却件数(デフォルト: 100、最大: 1000)
例:
{
"date": "2025-11-07",
"count": 50
}3. search_by_keyword
キーワードで入札情報を検索します。
パラメータ:
keyword(string, 必須): 検索キーワードcount(number, 任意): 返却件数(デフォルト: 100、最大: 1000)
例:
{
"keyword": "情報システム",
"count": 20
}レスポンス形式
MCP版(stdio)
すべてのツールは以下の形式でレスポンスを返します:
{
"searchHits": 262,
"results": [
{
"resultId": 1,
"key": "...",
"externalDocumentURI": "https://...",
"projectName": "第2069号小中学校児童生徒用机・いす",
"date": "2025-11-07T19:08:01+09:00",
"fileType": "pdf",
"fileSize": 134411,
"lgCode": "19",
"prefectureName": "山梨県",
"cityCode": "192015",
"cityName": "甲府市",
"organizationName": "山梨県甲府市",
"cftIssueDate": "2025-11-07T00:00:00+09:00",
"category": "物品",
"procedureType": "一般競争入札",
"projectDescription": "...",
"attachments": [
{
"name": "入札説明書(PDF:132KB)",
"uri": "https://..."
}
]
}
]
}HTTP版
HTTPサーバー版は以下の形式でレスポンスを返します:
{
"success": true,
"data": {
"searchHits": 262,
"results": [
{
"resultId": 1,
"projectName": "第2069号小中学校児童生徒用机・いす",
"organizationName": "山梨県甲府市",
"cftIssueDate": "2025-11-07T00:00:00+09:00",
"category": "物品",
"procedureType": "一般競争入札",
...
}
]
}
}エラーの場合:
{
"success": false,
"error": "エラーメッセージ"
}注意事項
このAPIは官公需情報ポータルサイトのAPIを使用しています
登録・認証は不要で誰でも利用可能です
利用規約を遵守してください
APIのレスポンスはXML形式ですが、このMCPサーバーはJSON形式に変換して返します
参考資料
ライセンス
MIT
Available Tools
3 toolsget_procurements_by_dateA
指定した日付の入札情報を取得します。公告日で検索します。
Inputs: date (required), count.
search_by_keywordC
キーワードで入札情報を検索します。
Inputs: keyword (required), count.
search_procurementsA
官公需情報ポータルサイトAPIを使用して入札情報を検索します。日付、キーワード、カテゴリー、都道府県などで絞り込めます。
Inputs: count, query, lgCode, category, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
search_procurements already supports keyword and date filters, making get_procurements_by_date and search_by_keyword redundant specializations. Agents may struggle to decide which tool to use, as the boundaries are unclear and overlapping.
All tool names follow a verb_noun pattern with consistent snake_case style. The slight inconsistency is that 'search_by_keyword' does not explicitly mention 'procurements' like the others, but it remains readable and predictable.
Three tools is a reasonable count for a focused procurement search server. However, two tools are largely redundant subsets of the first, which suggests the count could be trimmed without losing functionality.
The server covers general search, date-based lookup, and keyword lookup, but lacks a way to fetch a specific procurement by ID or view detailed information. This is a notable gap for a procurement search domain.
Maintenance
Related MCP Connectors
全国の官公庁や自治体の入札・公募を、ClaudeやChatGPTから検索できる「入札公募検索」の公式MCPサーバーです。Search Japanese public tenders.
Read-only MCP for Japan's KKJ public procurement notices (free, 7 tools, MCP Apps UI).
MCP server for French (BOAMP) + EU (TED) public procurement data via TenderAPI.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceMCP server for Japan's Jグランツ grant application system, enabling LLMs to search and retrieve subsidy information via natural language.51MIT- AlicenseNot gradedqualityAmaintenanceRead-only MCP server for searching Japanese government procurement bid notices (官公需) from the SME Agency's KKJ portal. Includes AI ranking, PDF requirement extraction, and CSV/calendar export.49 npmApache 2.0
- AlicenseBqualityBmaintenanceMCP server for the Japan National Tax Agency Corporate Number API, enabling corporate number lookup and search via local AI clients.31MIT
- AlicenseAqualityDmaintenanceMCP server for searching and retrieving Japanese laws from the e-Gov API, enabling natural language queries for legal information.37 npmMIT