kklab-mlit-dpf-mcp
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"mlit-dpf-mcp": {
"args": [
"--directory",
"/絶対/mlit-dpf-mcp",
"run",
"python",
"-m",
"src.server"
],
"command": "uv",
"env": {
"MLIT_API_KEY": "your_api_key_here",
"MLIT_BASE_URL": "https://www.mlit-data.jp/api/v1/"
}
}
}
}服务介绍
MLIT DATA PLATFORM MCP Server
** 重要免責事項**
本国土交通省公式 mlit-dpf-mcp 利用作成非公式
国土交通省認可承認受
本利用生損失及障害等作成者責任負
目次
1. 概要
本国土交通省公式 mlit-dpf-mcp 作成非公式MCP (Model Context Protocol)
国土交通省保有民間等連携一元的検索表示可能国土交通提供利用者向API接続
本MCP利用大規模言語LLM直接連携対話形式直感的検索取得可能API関専門的知識誰簡単国土交通曖昧指示複雑条件設定検索取得可能新活用提供
** 本国土交通省認可承認受個人作成非公式**
2. 主機能
国土交通利用者向API活用以下機能提供
search指定検索並替件数指定可能search_by_location_rectangle指定矩形範囲交差検索search_by_location_point_distance指定地点半径円形範囲交差検索search_by_attribute名名都道府県市区町村属性指定検索get_data詳細情報取得get_data_summaryID基本情報取得get_data_catalog詳細情報取得get_data_catalog_summaryID基本情報取得get_file_download_urls用URL取得有効期限60秒get_zipfile_download_url複数ZIP形式URL取得有効期限60秒get_thumbnail_urls画像URL取得有効期限60秒get_all_data条件一致大量一括取得get_count_data条件一致件数取得get_suggest検索時候補取得get_prefecture_data都道府県名一覧取得get_municipality_data市区町村名一覧取得get_mesh指定含取得normalize_codes入力都道府県名市区町村名正規化
3. 動作環境
- OSWindows 10 / 11 macOS 13以降
- MCPClaude Desktop
- MCP実行環境Python 3.10+
- 8GB以上推奨
- 空容量 1GB以上含
4.
本MCPClaude Desktop Claude Code 両方使用設定方法以下説明
共通準備手順
環境以下準備必要
1. API取得
国土交通作成API取得
2.
git clone https://github.com/MLIT-DATA-PLATFORM/mlit-dpf-mcp.git
cd mlit-dpf-mcp
4.1. Claude Desktop使用方法
Claude Desktop使用場合設定方法
前提条件
- Claude Desktop
- Python 3.10以上
手順
1. 仮想環境作成 & 有効化
python -m venv .venv
.venv\Scripts\activate # Windows
source .venv/bin/activate # macOS/Linux
2. 依存
pip install -e .
pip install aiohttp pydantic tenacity python-json-logger mcp python-dotenv
3. 環境変数設定
.env.example .env 作成
MLIT_API_KEY=your_api_key_here
MLIT_BASE_URL=https://www.mlit-data.jp/api/v1/
your_api_key_here必手順1取得API置換
4. Claude Desktop設定開
- Windows
C:\Users\<名>\AppData\Roaming\Claude\claude_desktop_config.json - macOS
~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop設定画面開発者設定編集
claude_desktop_config.json開可能
5. MCP構成追加
{
"mcpServers": {
"mlit-dpf-mcp": {
"command": "......./mlit-dpf-mcp/.venv/Scripts/python.exe",
"args": [
"....../mlit-dpf-mcp/src/server.py"
],
"env": {
"MLIT_API_KEY": "your_api_key_here",
"MLIT_BASE_URL": "https://www.mlit-data.jp/api/v1/",
"PYTHONUNBUFFERED": "1",
"LOG_LEVEL": "WARNING"
}
}
}
}
command``args必実際変更
your_api_key_here必手順1取得API置換
6. Claude Desktop 再起動
4.2. Claude Code使用方法
Claude CodeVS Code拡張機能使用場合設定方法
前提条件
- Visual Studio Code
- Claude Code 拡張機能
- Python 3.10以上
uvpip
手順
1. 移動
cd mlit-dpf-mcp
2. 依存
uv使用場合推奨:
uv pip install -e .
通常pip使用:
pip install -e .
3. MCP設定作成
.mcp.json 作成
4. MCP設定記述
.mcp.json 以下内容記述
{
"mcpServers": {
"mlit-dpf-mcp": {
"command": "uv",
"args": [
"--directory",
"/絶対/mlit-dpf-mcp",
"run",
"python",
"-m",
"src.server"
],
"env": {
"MLIT_API_KEY": "your_api_key_here",
"MLIT_BASE_URL": "https://www.mlit-data.jp/api/v1/"
}
}
}
}
重要設定項目:
"/絶対/mlit-dpf-mcp": 絶対置換- Linux/macOS例:
"/home/username/mlit-dpf-mcp" - Windows例:
"C:/Users/username/mlit-dpf-mcp"(使用)
- Linux/macOS例:
"your_api_key_here": 取得API置換
注意: .mcp.json 配置.claude/ 内
5. VS Code開
code .
6. Claude Code起動
VS CodeCtrl+Shift+P / Cmd+Shift+PClaude Code: Start選択
7. MCP接続確認
Claude Code画面MCP利用可能確認mcp__mlit-dpf-mcp__始各種表示
Claude Code
MCP起動場合:
.mcp.json正確認配置- API正設定確認
- VS Code出力Output PanelClaude Code選択確認
依存関係出場合:
uv pip install aiohttp pydantic tenacity python-json-logger mcp python-dotenv
5. 使用例
5.1. 基本的検索
MCP正設定Claude DesktopClaude Code自然言語対話形式検索
例検索
東京都教
Claude自動的MCP使用以下処理実行
- 都道府県名東京都正規化13取得
- 便覧dhb検索
- 該当表示
例位置情報検索
東京駅半径5km以内公共施設検索
例可視化
岐阜県地図
5.2. 地図作成
東海地方地図含
含
plot_tokai_dams.py- 地図生成tokai_dams.json- 東海地方12件tokai_dams_map.html- 生成地図fetch_tokai_dams.py,get_tokai_dams.py- 取得用
実行方法
1. 必要
uv pip install folium
pip install folium
2. 地図生成
python plot_tokai_dams.py
3. 地図開
# Linux/macOS
xdg-open tokai_dams_map.html
# Windows
start tokai_dams_map.html
地図特徴
- 都道府県色分
- 赤愛知県
- 青岐阜県
- 緑静岡県
- 紫三重県
- 詳細情報表示
- MarkerCluster機能見表示
- 操作
全216件取得完全地図作成場合Claude CodeClaude Desktop以下依頼
東海地方全取得tokai_dams.json更新
6.
問題解決方法
1. MCP起動
症状 Claude DesktopClaude CodeMCP表示
解決方法
- 設定正確認
- API正設定確認
- Python環境正確認
Claude Desktop場合
# 確認
which python # macOS/Linux
where python # Windows
Claude Code場合
VS Code出力OutputClaude Code選択確認
2. API
症状 MLIT_API_KEY is not set
解決方法
.mcp.jsonClaude Codeclaude_desktop_config.jsonClaude DesktopMLIT_API_KEY正設定確認- API余分引用符含確認
- 国土交通API有効確認
3. 依存関係
症状 ModuleNotFoundError: No module named 'aiohttp'
解決方法
# 必要再
uv pip install aiohttp pydantic tenacity python-json-logger mcp python-dotenv
#
pip install aiohttp pydantic tenacity python-json-logger mcp python-dotenv
4. 地図生成
症状 ModuleNotFoundError: No module named 'folium'
解決方法
uv pip install folium
#
pip install folium
5. 取得
症状 検索結果返
解決方法
- API有効性確認
- 検索条件変更簡略化範囲広
- 接続確認
- API制限達確認
方法
変更
詳細確認場合設定LOG_LEVEL変更
Claude Desktopclaude_desktop_config.json
"env": {
"LOG_LEVEL": "DEBUG"
}
Claude Code.mcp.json
"env": {
"LOG_LEVEL": "DEBUG"
}
手動起動
MCP正動作手動起動
cd mlit-dpf-mcp
export MLIT_API_KEY=your_api_key_here
export MLIT_BASE_URL=https://www.mlit-data.jp/api/v1/
python -m src.server
表示場合従問題解決
7. 構成
mlit-dpf-mcp/
.mcp.json # MCP設定Claude Code用
.claude/ # Claude Code設定権限設定
settings.local.json # 権限設定
src/
server.py # MCP & 定義
client.py # MLIT GraphQL API
schemas.py # Pydantic 入力
config.py # 環境変数 & 設定検証
utils.py # 制限
plot_tokai_dams.py # 地図用
fetch_tokai_dams.py # 取得
get_tokai_dams.py # 取得
tokai_dams.json # 東海地方
tokai_dams_map.html # 生成地図HTML
pyproject.toml # 設定
uv.lock # 依存関係
README.md #
LICENSE #
.env.example # 環境変数
8.
本MIT提供詳細LICENSE参照
9. 注意事項
非公式
- 本国土交通省公式 mlit-dpf-mcp 作成非公式
- 国土交通省認可承認推奨受
- 本個人作成国土交通省国土交通一切関係
利用
免責事項
- 本非公式提供動作保証行
- 本内容予告変更削除可能性
- 本利用生損失及障害等作成者一切責任負
- 本関問合国土交通省国土交通行
