taxlaw-nts-mcp

STDIO-сервер для поиска материалов в Системе информации о налоговом законодательстве (https://taxlaw.nts.go.kr) с помощью инструментов MCP.

Сервер дополняет поиск интерпретаций налогового законодательства, запросов и ответов, документов по налоговым спорам, основных правил, таблиц/форм, публикаций и примеров консультаций Hometax, которые сложно найти напрямую через Министерство законодательства.

Для доступа к меню, для которых еще нет специализированных высокоуровневых инструментов, предоставляются функции просмотра списка подтвержденных меню/действий сайта, вызова action.do в исходном виде, а также инструмент для получения HTML-текста страниц сайта.

English

Как использовать вместе с korean-law-mcp

Для запросов по налоговому законодательству рекомендуется сначала использовать korean-law-mcp для проверки статей законов, указов, прецедентов и налоговых решений в базе данных Министерства законодательства. Если в поиске Министерства законодательства не удалось найти ответы на запросы, основные правила, примеры консультаций Hometax или публикации Национальной налоговой службы, используйте этот сервер для дополнительного поиска.

Если оба MCP находят одни и те же прецеденты, решения или интерпретации, объединяйте их в один результат на основе номера документа/запроса/дела (без пробелов и дефисов), даты создания/принятия решения и заголовка. Не дублируйте одинаковые элементы, указывая идентификаторы источников обоих серверов. Результаты этого сервера дополняют общую картину оригиналами фрагментов, консультациями Hometax, основными правилами и публикациями, доступными только в Системе информации о налоговом законодательстве.

Этот сервер отображает только те элементы, которые присутствуют в ответах Системы информации о налоговом законодательстве. В случае неудачного поиска или ошибки внешнего сайта возвращаются маркеры типа [NOT_FOUND], [EXTERNAL_API_ERROR], [INVALID_PARAMETER] с предупреждением о недопустимости догадок.

Related MCP server: Korean Law ALIO MCP

Предоставляемые инструменты

Доступ ко всем меню

Сначала используйте list_taxlaw_site_menus для проверки ключа меню, URL, подтвержденного actionId и параметров defaultParamData. Для меню, имеющих специализированные инструменты, используйте их. Для остальных меню передавайте actionId, defaultParamData и refererPath в call_taxlaw_action для получения исходного ответа. Материалы, предоставляемые в виде статического HTML (например, сводная информация по видам налогов или предложения по изменению законодательства), запрашиваются через get_taxlaw_page_text с передачей путей типа /html/U_0101.html или /cm/USECMJ001M.do. Налоговый календарь можно запросить, передав year и month в действие ASECMC001MR01, найденное через list_taxlaw_site_menus(query="세무일정").

Быстрый старт

npm install
npm run build
npm start

Для запуска из локального исходного пути в MCP-клиенте:

{
  "mcpServers": {
    "taxlaw-nts": {
      "command": "node",
      "args": ["/absolute/path/to/taxlaw-nts-mcp/build/index.js"]
    }
  }
}

После публикации в npm можно зарегистрировать его короче после глобальной установки.

npm install -g taxlaw-nts-mcp

{
  "mcpServers": {
    "taxlaw-nts": {
      "command": "taxlaw-nts-mcp"
    }
  }
}

Переменные окружения

API-ключ не требуется. Можно изменить только User-Agent, используемый для вызовов Системы информации о налоговом законодательстве, если это необходимо.

TAXLAW_USER_AGENT="Mozilla/5.0 ..."

Принципы обработки ошибок

Если результаты поиска или подробного запроса отсутствуют, возвращается [NOT_FOUND] и isError: true. Ошибки внешнего сайта возвращаются как [EXTERNAL_API_ERROR], неверные входные данные — как [INVALID_PARAMETER]. В теле результата указываются URL источника и фактически запрошенный ID.

Разработка

npm run build
npm run watch
npm pack --dry-run

Лицензия

MIT