taxlaw-nts-mcp

这是一个使用 MCP 工具搜索国税法令信息系统（https://taxlaw.nts.go.kr）资料的 STDIO 服务器。

该工具用于补充搜索在韩国法制处难以直接找到的国税厅税法解释、咨询回复、税务诉讼文档、基本通则、附表/格式、出版手册及 Hometax 咨询案例。

为了能够访问尚无专用高阶工具的菜单，还提供了已确认的网站菜单/action 列表查询、action.do 原始调用以及同站 HTML 文本查询工具。

English

与 korean-law-mcp 的配合使用方式

建议的税法咨询流程是：首先使用 korean-law-mcp 确认法制处/法令数据库中的法令条文、施行令、判例、税务审判等资料；当在法制处搜索中无法找到国税厅咨询回复、基本通则、Hometax 咨询案例或出版手册时，再使用本服务器进行补充查询。

当两个 MCP 找到相同的判例、决定例或解释例时，请根据文档编号/请求编号/案件编号（去除空格和连字符）、生产日期/议决日期及标题进行整合。相同项目请勿重复列出，应同时保留双方的出处 ID，并使用本服务器的结果补充仅存在于国税法令信息系统中的原文片段、Hometax 咨询、基本通则及出版手册。

本服务器仅显示国税法令信息系统响应中存在的项目。如果搜索失败或出现外部网站错误，将返回 [NOT_FOUND]、[EXTERNAL_API_ERROR]、[INVALID_PARAMETER] 等标记，并禁止进行推测。

Related MCP server: Korean Law ALIO MCP

提供工具

全菜单访问

首先使用 list_taxlaw_site_menus 确认菜单键、URL、已确认的 actionId 及默认 paramData。对于有专用工具的菜单，请使用相应的高阶工具；对于没有的菜单，请将 actionId、defaultParamData 和 refererPath 传递给 call_taxlaw_action 以查询原始响应。对于以静态 HTML 提供的资料（如税目摘要信息、税法修订建议），请将 /html/U_0101.html、/cm/USECMJ001M.do 等路径传递给 get_taxlaw_page_text 进行查询。税务日程可以通过在 list_taxlaw_site_menus(query="세무일정") 中确认的 ASECMC001MR01 action 传入 year 和 month 进行查询。

快速开始

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