taxlaw-nts-mcp

Ein STDIO-Server, der MCP-Tools verwendet, um Daten aus dem Informationssystem für Steuergesetze (https://taxlaw.nts.go.kr) zu durchsuchen.

Ergänzt die Suche nach Interpretationen des Steuerrechts, Anfragen und Antworten, Steuerstreitdokumenten, Grundsatzregeln, Anhängen/Formularen, Publikationen und Hometax-Beratungsfällen des Nationalen Steuerdienstes, die über das Gesetzgebungsministerium nur schwer direkt zu finden sind.

Um den Zugriff auf Menüs zu ermöglichen, für die noch keine dedizierten High-Level-Tools existieren, werden Funktionen zum Abrufen der bestätigten Website-Menüs/Action-Listen, zum rohen Aufruf von action.do sowie zum Abrufen von HTML-Texten der Website bereitgestellt.

English

Verwendung zusammen mit korean-law-mcp

Für steuerrechtliche Anfragen wird empfohlen, zuerst korean-law-mcp zu verwenden, um Gesetzesartikel, Durchführungsverordnungen, Präzedenzfälle und Steuerentscheidungen aus der Datenbank des Gesetzgebungsministeriums zu prüfen. Wenn die Suche beim Gesetzgebungsministerium keine Ergebnisse zu Interpretationen des Steuerrechts, Grundsatzregeln, Hometax-Beratungsfällen oder Publikationen liefert, sollte dieser Server zur ergänzenden Suche verwendet werden.

Wenn beide MCPs dieselben Präzedenzfälle, Entscheidungen oder Interpretationen finden, sollten diese anhand der Dokumentennummer/Antragsnummer/Fallnummer (ohne Leerzeichen und Bindestriche), des Erstellungs-/Entscheidungsdatums und des Titels zusammengeführt werden. Doppelte Einträge sollten nicht mehrfach aufgelistet werden; stattdessen sollten beide Quell-IDs angegeben werden. Original-Textausschnitte, Hometax-Beratungen, Grundsatzregeln und Publikationen, die nur im Informationssystem für Steuergesetze verfügbar sind, werden durch die Ergebnisse dieses Servers ergänzt.

Dieser Server zeigt nur Elemente an, die in den Antworten des Informationssystems für Steuergesetze enthalten sind. Bei Suchfehlern oder Fehlern externer Websites werden Marker wie [NOT_FOUND], [EXTERNAL_API_ERROR] oder [INVALID_PARAMETER] zusammen mit einer Warnung vor Spekulationen zurückgegeben.

Related MCP server: Korean Law ALIO MCP

Verfügbare Tools

Zugriff auf das gesamte Menü

Prüfen Sie zuerst mit list_taxlaw_site_menus die Menüschlüssel, URLs, bestätigten actionIds und Standard-paramData. Verwenden Sie für Menüs mit dedizierten Tools diese High-Level-Tools. Für Menüs ohne dedizierte Tools übergeben Sie actionId, defaultParamData und refererPath an call_taxlaw_action, um die rohe Antwort abzurufen. Materialien, die als statisches HTML bereitgestellt werden (z. B. Zusammenfassungen nach Steuerart oder Vorschläge zur Steuergesetzänderung), können durch Übergabe von Pfaden wie /html/U_0101.html oder /cm/USECMJ001M.do an get_taxlaw_page_text abgerufen werden. Steuertermine können durch Übergabe von year und month an die ASECMC001MR01-Aktion abgerufen werden, die unter list_taxlaw_site_menus(query="세무일정") identifiziert wurde.

Schnelleinstieg

npm install
npm run build
npm start

Um es in einem MCP-Client aus einem lokalen Quellpfad auszuführen:

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

Nach der Veröffentlichung auf npm kann es nach einer globalen Installation kürzer registriert werden.

npm install -g taxlaw-nts-mcp

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

Umgebungsvariablen

Es ist kein API-Schlüssel erforderlich. Der User-Agent für Aufrufe an das Informationssystem für Steuergesetze kann bei Bedarf geändert werden.

TAXLAW_USER_AGENT="Mozilla/5.0 ..."

Prinzipien für Fehlermeldungen

Wenn keine Such- oder Detailergebnisse gefunden werden, wird [NOT_FOUND] und isError: true zurückgegeben. Fehler externer Websites werden als [EXTERNAL_API_ERROR] und ungültige Eingaben als [INVALID_PARAMETER] zurückgegeben. Der Ergebnistext enthält sowohl die Quell-URL als auch die tatsächlich abgefragte ID.

Entwicklung

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

Lizenz

MIT