japan-data-mcp — MCP-сервер для Claude Code: что умеет и запуск
Подключает к ассистенту открытую статистику e-Stat, реестры юрлиц и цены на недвижимость в Японии. Позволяет сравнивать муниципалитеты без ручной возни с кодами.
claude mcp add japan-data-mcp -e ESTAT_APP_ID=<ESTAT_APP_ID> -e CORP_APP_ID=<CORP_APP_ID> -e REALESTATE_API_KEY=<REALESTATE_API_KEY> -- uvx japan-data-mcpЧто делает japan-data-mcp
Сервер объединяет четыре официальных источника Японии: статистику e-Stat, реестр корпоративных номеров, базу счетов-фактур и сводки сделок с недвижимостью. Инструмент сам переводит числовые коды ведомств вроде 13000 в названия префектур и городов. Каталог охватывает 47 префектур и порядка 1700 муниципалитетов.
Без переменной окружения ESTAT_APP_ID сервер не запустится вовсе. Это единственный обязательный ключ, получить его можно бесплатно. Доступ к корпоративному API оформляется от двух до четырёх недель, но для демографических выборок он не нужен. Готовые функции вроде get_population или compare_regions сразу возвращают свежие показатели со ссылкой на первоисточник.
Какие задачи решает
- сопоставить население и доходы разных городов Японии через сводные таблицы
- найти регистрационные данные компании по её японскому наименованию
- проверить валидность номера счёта-фактуры на заданную дату
- выгрузить цены сделок с недвижимостью за выбранный год
Примеры запросов агенту
- Сравни население городов Саппоро, Сендай и Фукуока через
compare_regions - Найди сведения о компании Тойота в префектуре Айти через
search_corporations - Проверь статус регистрации счёта-фактуры по номеру через
check_invoice_registration
Как установить japan-data-mcp
Командой платформы
claude mcp add japan-data-mcp -e ESTAT_APP_ID=<ESTAT_APP_ID> -e CORP_APP_ID=<CORP_APP_ID> -e REALESTATE_API_KEY=<REALESTATE_API_KEY> -- uvx japan-data-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from japan-data-mcp <команда>
Командой платформы
codex mcp add japan-data-mcp --env ESTAT_APP_ID=<ESTAT_APP_ID> --env CORP_APP_ID=<CORP_APP_ID> --env REALESTATE_API_KEY=<REALESTATE_API_KEY> -- uvx japan-data-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from japan-data-mcp <команда>
Файл настроек
{
"mcpServers": {
"japan-data-mcp": {
"command": "uvx",
"args": [
"japan-data-mcp"
],
"env": {
"ESTAT_APP_ID": "<ESTAT_APP_ID>",
"CORP_APP_ID": "<CORP_APP_ID>",
"REALESTATE_API_KEY": "<REALESTATE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from japan-data-mcp <команда>
Файл настроек
{
"servers": {
"japan-data-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"japan-data-mcp"
],
"env": {
"ESTAT_APP_ID": "<ESTAT_APP_ID>",
"CORP_APP_ID": "<CORP_APP_ID>",
"REALESTATE_API_KEY": "<REALESTATE_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from japan-data-mcp <команда>
Командой платформы
gemini mcp add -e ESTAT_APP_ID=<ESTAT_APP_ID> -e CORP_APP_ID=<CORP_APP_ID> -e REALESTATE_API_KEY=<REALESTATE_API_KEY> japan-data-mcp uvx japan-data-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from japan-data-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о japan-data-mcp
Как установить japan-data-mcp в Claude Code?
Выполните команду `claude mcp add japan-data-mcp -e ESTAT_APP_ID=<ESTAT_APP_ID> -e CORP_APP_ID=<CORP_APP_ID> -e REALESTATE_API_KEY=<REALESTATE_API_KEY> -- uvx japan-data-mcp. Обязательным является только ключ ESTAT_APP_ID`.
Зачем нужен этот MCP-сервер?
Он даёт ассистенту прямой доступ к государственной статистике e-Stat, данным о японских юридических лицах и стоимости жилья. Ответы приходят в структурированном виде с указанием первоисточника и даты выгрузки.
Обязательно ли получать все три API-ключа для запуска?
Нет, сервер требует только ESTAT_APP_ID от портала e-Stat. Ключи для базы юрлиц и реестра недвижимости опциональны, их можно подключить позже.
