taxlaw-nts-mcp

Un servidor STDIO que utiliza herramientas MCP para buscar datos en el Sistema de Información de Leyes Fiscales Nacionales (https://taxlaw.nts.go.kr).

Realiza búsquedas complementarias de interpretaciones de leyes fiscales del Servicio Nacional de Impuestos, consultas y respuestas, documentos de apelación fiscal, normas básicas, tablas/formularios, folletos publicados y casos de consulta de Hometax que son difíciles de encontrar directamente a través del Ministerio de Legislación Gubernamental.

Para acceder a menús que aún no cuentan con herramientas de alto nivel dedicadas, se proporcionan herramientas para consultar la lista de menús/acciones confirmados del sitio, realizar llamadas crudas a action.do y consultar texto HTML del mismo sitio.

English

Cómo usarlo junto con korean-law-mcp

Para consultas sobre leyes fiscales, se recomienda el siguiente flujo: primero, utilice korean-law-mcp para verificar artículos de leyes, decretos de ejecución, jurisprudencia y arbitraje fiscal en la base de datos del Ministerio de Legislación Gubernamental; cuando no encuentre las interpretaciones de leyes fiscales, consultas, normas básicas, casos de consulta de Hometax o folletos publicados del Servicio Nacional de Impuestos en la búsqueda del Ministerio, utilice este servidor para una búsqueda complementaria.

Si ambos MCP encuentran la misma jurisprudencia, decisión o interpretación, consolídelos en uno solo basándose en el número de documento/número de reclamación/número de caso (eliminando espacios y guiones), la fecha de producción/fecha de resolución y el título. No enumere elementos duplicados; incluya los ID de origen de ambos lados y utilice los resultados de este servidor para complementar con fragmentos de texto originales, consultas de Hometax, normas básicas y folletos publicados que solo se encuentran en el Sistema de Información de Leyes Fiscales Nacionales.

Este servidor solo muestra elementos presentes en las respuestas del Sistema de Información de Leyes Fiscales Nacionales. Si la búsqueda falla o hay un error en el sitio externo, devolverá marcadores como [NOT_FOUND], [EXTERNAL_API_ERROR] o [INVALID_PARAMETER] junto con una advertencia de no realizar suposiciones.

Related MCP server: Korean Law ALIO MCP

Herramientas proporcionadas

Acceso a todos los menús

Primero, utilice list_taxlaw_site_menus para verificar la clave del menú, la URL, el actionId confirmado y los paramData predeterminados. Para menús con herramientas dedicadas, utilice la herramienta de alto nivel correspondiente; para los que no, pase el actionId, defaultParamData y refererPath a call_taxlaw_action para obtener la respuesta cruda. Para materiales proporcionados como HTML estático, como información resumida por impuesto o propuestas de reforma fiscal, pase rutas como /html/U_0101.html o /cm/USECMJ001M.do a get_taxlaw_page_text. Los calendarios fiscales pueden consultarse pasando year y month a la acción ASECMC001MR01 confirmada en list_taxlaw_site_menus(query="세무일정") |

Inicio rápido

npm install
npm run build
npm start

Para ejecutar desde la ruta de origen local en un cliente MCP:

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

Después de publicar en npm, puede registrarlo de forma más breve tras una instalación global:

npm install -g taxlaw-nts-mcp

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

Variables de entorno

No se requiere una clave API. Solo puede cambiar el User-Agent que se utilizará para las llamadas al Sistema de Información de Leyes Fiscales Nacionales cuando sea necesario.

TAXLAW_USER_AGENT="Mozilla/5.0 ..."

Principios de respuesta ante errores

Si no hay resultados de búsqueda o consulta detallada, se devolverá [NOT_FOUND] con isError: true. Los errores del sitio externo se devolverán como [EXTERNAL_API_ERROR] y las entradas incorrectas como [INVALID_PARAMETER]. El cuerpo del resultado mostrará tanto la URL de origen como el ID consultado realmente.

Desarrollo

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

Licencia

MIT