Token导航 LogoToken导航TokenDH.com
MLIT Data Platform MCP Server logo
搜索检索stdio官方来源来源级核验

MLIT Data Platform MCP Server

MCP Server

非官方的MCP服务器,用于连接国土交通数据平台API,通过大语言模型实现自然语言交互式数据搜索与获取。

工具数

18

提示词数

0

GitHub Stars

0

资源数

0
PythonClaude搜索Claude DesktopClaudeVS Code

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

kkawailab

提供方

kkawailab

最后核验

2026/5/17 20:20

运行时

Python

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

python -m venv .venv

详细介绍

MLIT数据平台MCP服务器

⚠️ 重要免责声明 本资源库是国土交通省的官方资源库 mlit-dpf-mcp 中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。 没有得到国土交通省的认可和批准。 对于因使用本存储库而产生的任何损失及故障等,制作者不承担责任。

目次

- 目次 - 1. 概要 - 2.主要功能 - 3.动作环境 - 4.安装和安装 - 4.1. Claude Desktop使用方法 - 4.2. Claude Code使用方法 - 5. 使用例 - 5.1.基本搜索 - 5.2.水库地图的制作(样本项目) - 6.故障排除 - 7.目录配置 - 8.许可证 - 9.注意事项

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_summary(数据ID和标题等数据的基本信息。)
  • get_data_catalog(获取数据目录和数据集的详细信息。)
  • get_data_catalog_summary(ID获取数据目录和数据集的基本信息,例如标题。)
  • get_file_download_urls(文件下载用URL将条目添加到文档注册表。)
  • get_zipfile_download_url(将多个文件ZIP格式下载URL(有效期:60秒)
  • get_thumbnail_urls(缩略图图像的URL将条目添加到文档注册表。)
  • get_all_data(批量获取符合条件的大量数据。)
  • get_count_data(取得符合条件的数据件数。)
  • get_suggest(检索关键字时的候补。)
  • get_prefecture_data(获取都道府县名称、代码的一览表。)
  • get_municipality_data(获取市区町村名、代码的一览表。)
  • get_mesh(获取指定网格中包含的数据。)
  • normalize_codes(将输入的都道府县名、市区町村名正规化。)

3.动作环境

  • OS:Windows 10 / 11 或macOS 13以来
  • MCP主机:Claude Desktop等等
  • MCP服务器运行环境:Python 3.10+
  • 内存:8GB以上建议
  • 存储:可用空间1GB以上(包括高速缓存和日志)

4.安装和安装

本MCP服务器克劳德桌面克劳德代码 对较大场景进行渲染期间已观察到该故障。以下说明各自的设定方法。

通用准备程序

无论在哪个环境中,首先都需要进行以下准备。

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打开配置文件

  • 窗户: 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"
      }
    }
  }
}

commandargs必须将其更改为实际路径。 your_api_key_here必须在步骤1中获取API来修改标记元素的显示属性。

6. Claude Desktop 重新启动

______________________________________________________________________

4.2. Claude Code使用方法

Claude Code(VS 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" - 视窗例: "C:/Users/username/mlit-dpf-mcp" (使用斜线)

  • "your_api_key_here":已获取API请用键替换

注意: .mcp.json 请放置在项目的根目录中(.claude/ 不在目录中)

5. VS Code在中打开项目

code .

6. Claude Code启动

VS Code从命令选项板(Ctrl+Shift+P/Cmd+Shift+P)中选择“Claude Code:Start”。

7. MCP检查服务器连接

Claude Code对话框,您可以在此定义自定义格式MCP确保工具可用。单击功能区上🔧)列表框中,此格式对应于条目“无”mcp__mlit-dpf-mcp__对较大场景进行渲染期间已观察到该故障。

故障排除

MCP如果服务器未启动:

  1. .mcp.json 的路径是否正确(是否位于项目根目录中)
  2. API确认密钥是否正确设置
  3. VS Code在“输出面板”中选择“Claude Code”,确认错误日志

如果出现依赖关系错误:

uv pip install aiohttp pydantic tenacity python-json-logger mcp python-dotenv

______________________________________________________________________

5. 使用例

5.1.基本搜索

MCP如果服务器设置正确Claude Desktop或Claude Code中描述的场景,使用以下步骤创建明细表,以便在概念设计中分析体量的体积。

例:关键字检索

「東京都のダムを教えて」

Claude自动的MCP使用工具:

  1. 都道府县名“东京都”正规化,取得代码“13”
  2. 搜索数据集“水库便览(dhb)”
  3. 显示相应的水库列表

例:基于位置信息的检索

「東京駅から半径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 Code或Claude Desktop请按以下方式委托:

「東海地方の全てのダムデータを取得してtokai_dams.jsonを更新して」

______________________________________________________________________

6.故障排除

常见问题及解决办法

1. MCP服务器未启动

症状: Claude Desktop或Claude Code的MCP未显示工具

解决方法:

  • 确认配置文件的路径是否正确
  • API确认密钥是否正确设置
  • Python确定环境是否正确激活

Claude Desktop的情况:

# パスの確認
which python  # macOS/Linux
where python  # Windows

Claude Code的情况: VS Code在的输出面板(Output)中选择“Claude Code”,确认错误日志。

2. API密钥错误

症状: MLIT_API_KEY is not set 等错误信息

解决方法:

  • .mcp.json(Claude Code)或claude_desktop_config.json(Claude Desktop)在工作空间的边缘MLIT_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_desktop_config.json):

"env": {
  "LOG_LEVEL": "DEBUG"
}

克劳德代码(.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由许可证提供。详情许可证来修改标记元素的显示属性。

______________________________________________________________________

9.注意事项

关于非正式资源库

  • 本资源库是国土交通省的官方资源库 mlit-dpf-mcp 而需要与环境混合的每条反射光线,进行环境采样。
  • 没有得到国土交通省的认可、批准和推荐。
  • 本资料库由个人制作,与国土交通省及国土交通数据平台完全无关。

关于数据利用

免责事项

  • 本存储库是作为非正式应用程序提供的。不进行动作保证。
  • 本存储库的内容可能会在没有预告的情况下进行变更、删除。
  • 对于因使用本存储库而产生的损失及故障等,制作者不承担任何责任。
  • 请勿向国土交通省或国土交通数据平台咨询本资源库。

目录标签

目录标签

PythonClaude搜索数据搜索本地部署地理信息系统API集成自然语言处理政府数据

支持客户端

Claude DesktopClaudeVS Code

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

none

运行时(runtime,运行环境)

Python

部署方式(deploymentType,部署类型)

remote-capable

工具数量(toolCount,工具数)

18

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiononeremote-capable

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP