Skip to content
Back to search

mlit-dpf-mcp

MLIT DATA PLATFORM MCP Server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mlit-data-platform--mlit-dpf-mcp/badge.svg)](/listings/mlit-data-platform--mlit-dpf-mcp)

HTML

<a href="/listings/mlit-data-platform--mlit-dpf-mcp"><img src="/api/listings/mlit-data-platform--mlit-dpf-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 173 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MLIT DATA PLATFORM MCP Server
  2. ## 目次
  3. - [MLIT DATA PLATFORM MCP Server](#mlit-data-platform-mcp-server)
  4. - [目次](#目次)
  5. - [1. 概要](#1-概要)
  6. - [2. 主な機能](#2-主な機能)
  7. - [3. 動作環境](#3-動作環境)
  8. - [4. インストールとセットアップ](#4-インストールとセットアップ)
  9. - [前提条件](#前提条件)
  10. - [手順](#手順)
  11. - [5. ディレクトリ構成](#5-ディレクトリ構成)
  12. - [6. ライセンス](#6-ライセンス)
  13. - [7. 注意事項](#7-注意事項)
  14. - [8. お問い合わせ](#8-お問い合わせ)
  15. ## 1. 概要
  16. 国土交通省が保有するデータと民間等のデータを連携し、一元的に検索・表示・ダウンロードを可能にする[国土交通データプラットフォーム](https://data-platform.mlit.go.jp/)が提供する利用者向けAPIと接続するMCP (Model Context Protocol) サーバー(α版)です。
  17. 本MCPサーバーを利用することで、大規模言語モデル(LLM)と直接連携し、対話形式で直感的にデータを検索・取得することが可能になります。APIに関する専門的な知識がなくても、誰でも簡単に国土交通データプラットフォームから曖昧な指示や複雑な条件設定でデータを検索・取得が可能な、新しいデータ活用のかたちを提供します。
  18. ## 2. 主な機能
  19. 国土交通データプラットフォームの利用者向けAPIを活用し、以下の機能を提供します:
  20. * `search`(キーワードの指定によりデータを検索します。並べ替えや件数の指定も可能です。)
  21. * `search_by_location_rectangle`(指定した矩形範囲と交差するデータを検索します。)
  22. * `search_by_location_point_distance`(指定した地点と半径からなる円形範囲と交差するデータを検索します。)
  23. * `search_by_attribute`(カタログ名、データセット名、都道府県、市区町村などの属性を指定してデータを検索します。)
  24. * `get_data`(データの詳細情報を取得します。)
  25. * `get_data_summary`(データIDとタイトルなどのデータの基本情報を取得します。)
  26. * `get_data_catalog`(データカタログやデータセットの詳細情報を取得します。)
  27. * `get_data_catalog_summary`(IDやタイトルなどのデータカタログやデータセットの基本情報を取得します。)
  28. * `get_file_download_urls`(ファイルのダウンロード用URLを取得します(有効期限:60秒)。)
  29. * `get_zipfile_download_url`(複数ファイルをZIP形式でまとめたダウンロードURLを取得します(有効期限:60秒)。)
  30. * `get_thumbnail_urls`(サムネイル画像のURLを取得します(有効期限:60秒)。)
  31. * `get_all_data`(条件に一致する大量のデータを一括取得します。)
  32. * `get_count_data`(条件に一致するデータ件数を取得します。)
  33. * `get_suggest`(キーワード検索時の候補を取得します。)
  34. * `get_prefecture_data`(都道府県名・コードの一覧を取得します。)
  35. * `get_municipality_data`(市区町村名・コードの一覧を取得します。)
  36. * `get_mesh`(指定したメッシュに含まれるデータを取得します。)
  37. * `normalize_codes`(入力された都道府県名・市区町村名を正規化します。)
  38. ## 3. 動作環境
  39. * OS:Windows 10 / 11 または macOS 13以降
  40. * MCPホスト:Claude Desktopなど
  41. * MCPサーバー実行環境:Python 3.10+
  42. * メモリ:8GB以上推奨
  43. * ストレージ:空き容量 1GB以上(キャッシュやログを含む)
  44. ## 4. インストールとセットアップ
  45. ### 前提条件
  46. Claude DesktopなどのMCP対応AIアプリケーション および Python がインストールされていることを前提としています。以下は、Claude Desktopでの利用を想定した手順です。
  47. ### 手順
  48. 1. **国土交通データプラットフォームでアカウントを作成し、APIキーを取得**
  49. 詳しい手順は、[こちら](https://data-platform.mlit.go.jp/api_docs/usage/introduction.html)をご覧ください。
  50. 2. **リポジトリをクローン**
  51. ```bash
  52. git clone https://github.com/MLIT-DATA-PLATFORM/mlit-dpf-mcp.git
  53. cd mlit-dpf-mcp
  54. ```
  55. 3. **仮想環境を作成 & 有効化**
  56. ```bash
  57. python -m venv .venv
  58. .venv\Scripts\activate # Windows
  59. source .venv/bin/activate # macOS/Linux
  60. ```
  61. 4. **依存ライブラリをインストール**
  62. ```bash
  63. pip install -e .
  64. pip install aiohttp pydantic tenacity python-json-logger mcp python-dotenv
  65. ```
  66. 5. **環境変数を設定**
  67. `.env.example`をコピーし、 `.env` ファイルを作成します:
  68. ```
  69. MLIT_API_KEY=your_api_key_here
  70. MLIT_BASE_URL=https://data-platform.mlit.go.jp/api/v1/
  71. ```
  72. あるいはコマンドラインから直接設定することも可能です:
  73. ```bash
  74. export MLIT_API_KEY=your_api_key_here
  75. export MLIT_BASE_URL=https://data-platform.mlit.go.jp/api/v1/
  76. ```
  77. `your_api_key_here`は必ず、手順1で取得したAPIキーに置き換えてください。
  78. 6. **MCP サーバーの起動**
  79. ```bash
  80. python -m src.server
  81. ```
  82. 7. **Claude Desktopの設定ファイルを開く**
  83. * **Windows:** `C:\Users\<ユーザー名>\AppData\Roaming\Claude\claude_desktop_config.json`
  84. * **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
  85. * Claude Desktopアプリの設定画面にある「開発者」メニューの「設定を編集」ボタンをクリックして`claude_desktop_config.json`を開くことも可能です。
  86. 8. **MCPサーバーの構成を追加**
  87. ```json
  88. {
  89. "mcpServers": {
  90. "mlit-dpf-mcp": {
  91. "command": "......./mlit-dpf-mcp/.venv/Scripts/python.exe",
  92. "args": [
  93. "....../mlit-dpf-mcp/src/server.py"
  94. ],
  95. "env": {
  96. "MLIT_API_KEY": "your_api_key_here",
  97. "MLIT_BASE_URL": "https://data-platform.mlit.go.jp/api/v1/",
  98. "PYTHONUNBUFFERED": "1",
  99. "LOG_LEVEL": "WARNING"
  100. }
  101. }
  102. }
  103. }
  104. ```
  105. `command`と`args`は必ず、実際のパスに変更してください。
  106. `your_api_key_here`は必ず、手順1で取得したAPIキーに置き換えてください。
  107. 9. **Claude Desktop を再起動**
  108. ## 5. ディレクトリ構成
  109. ```
  110. mlit-dpf-mcp/
  111. ├─ src/
  112. │ ├─ server.py # MCP サーバー & ツール定義
  113. │ ├─ client.py # MLIT GraphQL API クライアント
  114. │ ├─ schemas.py # Pydantic モデル(入力バリデーション)
  115. │ ├─ config.py # 環境変数ロード & 設定検証
  116. │ └─ utils.py # ロギング、タイマー、レート制限
  117. ├─ pyproject.toml
  118. ├─ README.md
  119. └─ LICENSE
  120. ```
  121. ## 6. ライセンス
  122. * 本リポジトリはMITライセンスで提供されています。[ライセンス](./LICENSE)を参照してください。
  123. ## 7. 注意事項
  124. * 本リポジトリで提供されるデータの利用に関しては、 [国土交通データプラットフォームの利用規約](https://data-platform.mlit.go.jp/assets/policy/%E5%9B%BD%E5%9C%9F%E4%BA%A4%E9%80%9A%E3%83%87%E3%83%BC%E3%82%BF%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0%E5%88%A9%E7%94%A8%E8%A6%8F%E7%B4%84.pdf)に従う必要があります。ご使用前に国土交通データプラットフォームの利用規約を必ずご確認ください。
  125. * 本リポジトリの個人情報の取り扱いは、[国土交通データプラットフォームのプライバシーポリシー](https://data-platform.mlit.go.jp/assets/policy/%E5%9B%BD%E5%9C%9F%E4%BA%A4%E9%80%9A%E3%83%87%E3%83%BC%E3%82%BF%E3%83%97%E3%83%A9%E3%83%83%E3%83%88%E3%83%95%E3%82%A9%E3%83%BC%E3%83%A0_%E3%83%97%E3%83%A9%E3%82%A4%E3%83%90%E3%82%B7%E3%83%BC%E3%83%9D%E3%83%AA%E3%82%B7%E3%83%BC.pdf)に準拠しております。
  126. * 本リポジトリはα版として提供しているものです。動作保証は行っておりません。
  127. * 本リポジトリの内容は予告なく変更・削除する可能性があります。
  128. * 本リポジトリの利用により生じた損失及び障害等について、国土交通省及び国土交通データプラットフォームはいかなる責任も負わないものとします。
  129. ## 8. お問い合わせ
  130. 本リポジトリはα版です。お気づきの点があれば下記お問い合わせフォームまでご連絡下さい。
  131. * [国土交通データプラットフォームお問い合わせフォーム](https://forms.cloud.microsoft/pages/responsepage.aspx?id=6dtgrapYuEqgn0vEnGaJBOrx9xG7EpJLvmRgrTAinyBUQlpHVUQ2UEM0TUkwVUdMVE5HNUM0OTlXVyQlQCN0PWcu&route=shorturl)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.