Skip to main content
Glama
kanpou-mcp

kanpou-mcp

官報API MCPサーバー

官公需情報ポータルサイトAPI(官報API)をLLMやAIエージェントがツールとして使用できるようにするMCP(Model Context Protocol)サーバーです。

機能

このMCPサーバーは以下のツールを提供します:

  1. search_procurements - 詳細な検索条件で入札情報を検索

  2. get_procurements_by_date - 指定した日付の入札情報を取得

  3. 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 tools
get_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

    B3.2/5.0

    Scored across 3 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Japan's Jグランツ grant application system, enabling LLMs to search and retrieve subsidy information via natural language.
      51
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Read-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 npm
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      MCP server for the Japan National Tax Agency Corporate Number API, enabling corporate number lookup and search via local AI clients.
      3
      1
      MIT