@sugukuru/mcp-houjin-bangou 0.2.0

package/dist/tools/lookup-by-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-by-number.js","sourceRoot":"","sources":["../../src/tools/lookup-by-number.ts"],"names":[],"mappings":"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"}

package/dist/tools/normalize-company-name.d.ts

@@ -0,0 +1,60 @@
+/**
+ * T7: normalize_company_name
+ * 国税庁 `target=1` が吸収しきれない 7 パターンの表記揺れを補完
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 §4.6.2 (target=1 の内蔵あいまい検索の挙動)
+ *   本 MCP の核となる差別化軸
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare const OutputSchema: z.ZodObject<{
+    original: z.ZodString;
+    extracted_core_name: z.ZodString;
+    normalized_candidates: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        kind_hint: z.ZodEnum<{
+            unknown: "unknown";
+            state_agency: "state_agency";
+            local_government: "local_government";
+            kabushiki_kaisha: "kabushiki_kaisha";
+            yugen_kaisha: "yugen_kaisha";
+            gomei_kaisha: "gomei_kaisha";
+            goshi_kaisha: "goshi_kaisha";
+            godo_kaisha: "godo_kaisha";
+            ippan_shadan_hojin: "ippan_shadan_hojin";
+            ippan_zaidan_hojin: "ippan_zaidan_hojin";
+            koueki_shadan_hojin: "koueki_shadan_hojin";
+            koueki_zaidan_hojin: "koueki_zaidan_hojin";
+            npo_hojin: "npo_hojin";
+            other_registered: "other_registered";
+            foreign_company: "foreign_company";
+            other: "other";
+        }>;
+        prefix_or_suffix: z.ZodEnum<{
+            mae_kabu: "mae_kabu";
+            ato_kabu: "ato_kabu";
+            none: "none";
+        }>;
+        suggested_target: z.ZodEnum<{
+            1: "1";
+            2: "2";
+            3: "3";
+        }>;
+        confidence: z.ZodNumber;
+        applied_rules: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    fallback_note: z.ZodOptional<z.ZodString>;
+    recommendation: z.ZodString;
+    attribution: z.ZodObject<{
+        data_source: z.ZodString;
+        service_disclaimer: z.ZodString;
+        license: z.ZodLiteral<"公共データ利用規約 第1.0版">;
+        api_version: z.ZodLiteral<"Ver.4.0">;
+        accessed_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export type NormalizeCompanyNameOutput = z.infer<typeof OutputSchema>;
+export declare function registerNormalizeCompanyNameTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=normalize-company-name.d.ts.map

package/dist/tools/normalize-company-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-company-name.d.ts","sourceRoot":"","sources":["../../src/tools/normalize-company-name.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAyCP,CAAC;AAEZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AA4BtE,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8CxE"}

package/dist/tools/normalize-company-name.js

@@ -0,0 +1,130 @@
+/**
+ * T7: normalize_company_name
+ * 国税庁 `target=1` が吸収しきれない 7 パターンの表記揺れを補完
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第二編 §4.6.2 (target=1 の内蔵あいまい検索の挙動)
+ *   本 MCP の核となる差別化軸
+ */
+import { z } from 'zod';
+import { AttributionSchema, buildAttribution } from '../domain/corporate-number.js';
+import { normalizeCompanyName } from '../domain/normalizer.js';
+const InputSchema = z
+    .object({
+    raw_input: z
+        .string()
+        .min(1)
+        .max(500)
+        .describe('正規化したい会社名の文字列。名刺OCR結果・手入力・営業リストのセル等、表記揺れを含んでよい。'),
+})
+    .strict();
+const OutputSchema = z
+    .object({
+    original: z.string(),
+    extracted_core_name: z.string().describe('法人種別を除いたコア社名'),
+    normalized_candidates: z
+        .array(z.object({
+        name: z.string().describe('国税庁 API に投げる候補文字列'),
+        kind_hint: z.enum([
+            'state_agency',
+            'local_government',
+            'kabushiki_kaisha',
+            'yugen_kaisha',
+            'gomei_kaisha',
+            'goshi_kaisha',
+            'godo_kaisha',
+            'ippan_shadan_hojin',
+            'ippan_zaidan_hojin',
+            'koueki_shadan_hojin',
+            'koueki_zaidan_hojin',
+            'npo_hojin',
+            'other_registered',
+            'foreign_company',
+            'other',
+            'unknown',
+        ]),
+        prefix_or_suffix: z.enum(['mae_kabu', 'ato_kabu', 'none']),
+        suggested_target: z
+            .enum(['1', '2', '3'])
+            .describe('推奨する国税庁 name API の target パラメータ (1=あいまい / 2=完全 / 3=英語)'),
+        confidence: z.number().min(0).max(1),
+        applied_rules: z.array(z.string()),
+    }))
+        .max(10),
+    fallback_note: z.string().optional(),
+    recommendation: z.string().describe('次に呼ぶべき tool とパラメータの推奨'),
+    attribution: AttributionSchema,
+})
+    .strict();
+const DESCRIPTION = `名刺OCR・手入力・営業リスト等の不完全な会社名から、国税庁 API で検索可能な正規化候補を最大10件生成します。国税庁 API の内蔵あいまい検索 (target=1) が吸収しきれない 7 パターンを補完します:
+
+1. (株)/㈱/株式会社/（株）の表記・位置揺れ (前株・後株・省略の3展開)
+2. 法人種別の正規化・分離 (株式/有限/合同/合名/合資/一般社団/特定非営利活動 等)
+3. 英語法人名 → 日本語候補 (K.K. / Kabushiki Kaisha / Co.,Ltd. / Inc. / LLC 検出)
+4. 半角/全角英数字の正規化 (Unicode NFKC)
+5. 旧字体 → 新字体 (髙→高・齋→斎・﨑→崎 等、JIS第一・第二水準縮退補助)
+6. 異体字セレクタ (IVS / VS) の除去
+7. 空白類の揃え (タブ・連続スペース・全角/半角)
+
+USE THIS WHEN:
+- 名刺から抽出した会社名が (株) 表記で、国税庁検索でヒットしない
+- 営業リストの会社名に旧字体・異体字・英語表記が混在
+- OCR 結果の "(株)スグクル" を "株式会社スグクル" と "スグクル株式会社" の両方で検索したい
+- 英語名 "Sugukuru Inc." を日本語検索用と英語検索用 (target=3) の両方の候補にしたい
+
+DO NOT USE WHEN:
+- 会社名が既に綺麗に整形されている → search_corporate_by_name を直接使う
+- 13桁の法人番号が分かっている → lookup_corporate_by_number
+- 単に チェックデジット を検証したい → validate_corporate_number
+
+この tool の出力 normalized_candidates[i].name を search_corporate_by_name.name に、
+suggested_target を search_corporate_by_name.search_target に渡す想定です。
+
+注意: 国税庁 target=1 は 「ひらがな↔カタカナ」「英大小文字」「中点・全角空白削除」を自動吸収するため、これらの正規化は本 tool ではスキップされます (重複実装しない方針)。`;
+export function registerNormalizeCompanyNameTool(server) {
+    server.registerTool('normalize_company_name', {
+        title: 'Normalize Japanese company name (complements NTA target=1 fuzzy search)',
+        description: DESCRIPTION,
+        inputSchema: InputSchema.shape,
+        outputSchema: OutputSchema.shape,
+        annotations: {
+            title: 'Normalize Japanese company name',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        const input = InputSchema.parse(args);
+        const result = normalizeCompanyName(input.raw_input);
+        const topCandidate = result.normalized_candidates[0];
+        const recommendation = topCandidate !== undefined
+            ? `次に search_corporate_by_name を呼び、name="${topCandidate.name}" と search_target="${targetLabel(topCandidate.suggested_target)}" を指定してください。複数候補で試す場合は confidence 順に検索してください。`
+            : '正規化候補が生成されませんでした。入力を見直してください。';
+        const output = {
+            original: result.original,
+            extracted_core_name: result.extracted_core_name,
+            normalized_candidates: result.normalized_candidates,
+            ...(result.fallback_note !== undefined && { fallback_note: result.fallback_note }),
+            recommendation,
+            attribution: buildAttribution(),
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+function targetLabel(target) {
+    if (target === '1')
+        return 'fuzzy';
+    if (target === '2')
+        return 'exact';
+    return 'english';
+}
+//# sourceMappingURL=normalize-company-name.js.map

package/dist/tools/normalize-company-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-company-name.js","sourceRoot":"","sources":["../../src/tools/normalize-company-name.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-by-name.d.ts

@@ -0,0 +1,96 @@
+/**
+ * T2: search_corporate_by_name
+ * 法人名で国税庁公表サイトから法人情報を検索 (ページング対応)
+ *
+ * 根拠 / Source: 国税庁仕様書 第六編 §4, 第二編 §4
+ * エンドポイント: GET /4/name?id=...&name=<UTF-8 URLenc>&type=02&...
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NtaClient } from '../api/nta-client.js';
+import type { McpLogger } from '../lib/mcp-logger.js';
+declare const InputSchema: z.ZodObject<{
+    name: z.ZodString;
+    match_mode: z.ZodDefault<z.ZodEnum<{
+        prefix: "prefix";
+        partial: "partial";
+    }>>;
+    search_target: z.ZodDefault<z.ZodEnum<{
+        exact: "exact";
+        fuzzy: "fuzzy";
+        english: "english";
+    }>>;
+    prefecture: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "02": "02";
+        "01": "01";
+        "03": "03";
+        "04": "04";
+    }>>>;
+    include_history: z.ZodDefault<z.ZodBoolean>;
+    include_closed: z.ZodDefault<z.ZodBoolean>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const OutputSchema: z.ZodObject<{
+    total: z.ZodNumber;
+    page_number: z.ZodNumber;
+    page_size: z.ZodNumber;
+    corporations: z.ZodArray<z.ZodObject<{
+        corporate_number: z.ZodString;
+        sequence_number: z.ZodNumber;
+        process: z.ZodString;
+        correct: z.ZodEnum<{
+            0: "0";
+            1: "1";
+        }>;
+        update_date: z.ZodString;
+        change_date: z.ZodString;
+        name: z.ZodString;
+        name_image_id: z.ZodString;
+        kind: z.ZodString;
+        prefecture_name: z.ZodString;
+        city_name: z.ZodString;
+        street_number: z.ZodString;
+        address_image_id: z.ZodString;
+        prefecture_code: z.ZodString;
+        city_code: z.ZodString;
+        post_code: z.ZodString;
+        address_outside: z.ZodString;
+        address_outside_image_id: z.ZodString;
+        close_date: z.ZodString;
+        close_cause: z.ZodString;
+        successor_corporate_number: z.ZodString;
+        change_cause: z.ZodString;
+        assignment_date: z.ZodString;
+        latest: z.ZodEnum<{
+            0: "0";
+            1: "1";
+        }>;
+        en_name: z.ZodString;
+        en_prefecture_name: z.ZodString;
+        en_city_name: z.ZodString;
+        en_address_outside: z.ZodString;
+        furigana: z.ZodString;
+        hihyoji: z.ZodEnum<{
+            0: "0";
+            1: "1";
+        }>;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
+    last_update_date: z.ZodString;
+    attribution: z.ZodObject<{
+        data_source: z.ZodString;
+        service_disclaimer: z.ZodString;
+        license: z.ZodLiteral<"公共データ利用規約 第1.0版">;
+        api_version: z.ZodLiteral<"Ver.4.0">;
+        accessed_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export type SearchByNameInput = z.infer<typeof InputSchema>;
+export type SearchByNameOutput = z.infer<typeof OutputSchema>;
+export declare function registerSearchByNameTool(server: McpServer, deps: {
+    ntaClient: NtaClient;
+    logger: McpLogger;
+}): void;
+export {};
+//# sourceMappingURL=search-by-name.d.ts.map

package/dist/tools/search-by-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-by-name.d.ts","sourceRoot":"","sources":["../../src/tools/search-by-name.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAStD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;kBA8CN,CAAC;AAEZ,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUP,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAC5D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAkB9D,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAChD,IAAI,CAyHN"}

package/dist/tools/search-by-name.js

@@ -0,0 +1,176 @@
+/**
+ * T2: search_corporate_by_name
+ * 法人名で国税庁公表サイトから法人情報を検索 (ページング対応)
+ *
+ * 根拠 / Source: 国税庁仕様書 第六編 §4, 第二編 §4
+ * エンドポイント: GET /4/name?id=...&name=<UTF-8 URLenc>&type=02&...
+ */
+import { z } from 'zod';
+import { AttributionSchema, CorporationSchema, buildAttribution, } from '../domain/corporate-number.js';
+import { Result } from '../lib/result.js';
+import { computeNextCursor, decodeCursor } from '../lib/pagination.js';
+const InputSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .max(150)
+        .describe('商号又は名称 (日本語 150文字以内 / 英語 300文字以内)。UTF-8。'),
+    match_mode: z
+        .enum(['prefix', 'partial'])
+        .default('prefix')
+        .describe('検索方式。prefix=前方一致 (法人種別を除いた先頭から、mode=1)、partial=部分一致 (法人種別を含めて全体から、mode=2)。'),
+    search_target: z
+        .enum(['fuzzy', 'exact', 'english'])
+        .default('fuzzy')
+        .describe('検索対象。fuzzy=JIS第一・第二水準のあいまい検索 (target=1、ひらがな↔カタカナ・英大小文字・中点空白無視)、exact=JIS第一〜第四水準の完全一致 (target=2)、english=英語表記検索 (target=3)。'),
+    prefecture: z
+        .string()
+        .regex(/^(?:\d{2}|\d{5})$/)
+        .optional()
+        .describe('都道府県コード (2桁 JIS X 0401、01-47 or 99=国外) または 都道府県+市区町村 (5桁)。'),
+    kind: z
+        .array(z.enum(['01', '02', '03', '04']))
+        .max(4)
+        .optional()
+        .describe('法人種別フィルタ。01=国の機関, 02=地方公共団体, 03=設立登記法人, 04=外国会社等・その他。最大4件。'),
+    include_history: z
+        .boolean()
+        .default(false)
+        .describe('過去情報を検索対象に含めるか (change=1)。最新情報のみなら false。'),
+    include_closed: z
+        .boolean()
+        .default(true)
+        .describe('登記記録の閉鎖等があった法人も含めるか (close=1、デフォルト true)。'),
+    cursor: z
+        .string()
+        .optional()
+        .describe('ページング用の不透明カーソル (MCP 仕様準拠、opaque string)。'),
+})
+    .strict();
+const OutputSchema = z
+    .object({
+    total: z.number().int().nonnegative().describe('該当件数 (国税庁レスポンスヘッダ count)'),
+    page_number: z.number().int().positive(),
+    page_size: z.number().int().positive(),
+    corporations: z.array(CorporationSchema),
+    next_cursor: z.string().nullable().describe('次ページの cursor (最終ページなら null)'),
+    last_update_date: z.string().describe('国税庁公表DB の最終更新日 (YYYY-MM-DD)'),
+    attribution: AttributionSchema,
+})
+    .strict();
+const DESCRIPTION = `会社名で国税庁公表サイトから法人情報を検索します。国税庁 API 内蔵のあいまい検索 (target=1) が ひらがな↔カタカナ・英大小文字・中点削除 を自動で処理するので、多少の表記揺れは吸収できます。
+
+USE THIS WHEN:
+- 会社名 (日本語・英語) だけ分かっていて法人番号・住所を知りたい
+- 「鹿児島県の○○商事」を全部探したい (prefecture で絞り込み)
+- 営業リストを一括で enrich したい
+
+DO NOT USE WHEN:
+- 法人番号 (13桁) が分かっている → lookup_corporate_by_number を使う方が速くて確実
+- (株)/K.K./Co.,Ltd. などの表記揺れが激しい → まず normalize_company_name で候補化
+- 検索結果が多すぎる場合 (国税庁エラー 400-180): prefecture や kind で絞り込む
+
+ページング: 2000件超過時は国税庁側で分割レスポンスになります。次ページは next_cursor で取得。
+
+根拠: 国税庁 法人番号 Web-API 仕様書 第六編 §4、第二編 §4.6.1・§4.6.2 (target=1 内蔵あいまい検索の挙動)`;
+export function registerSearchByNameTool(server, deps) {
+    server.registerTool('search_corporate_by_name', {
+        title: 'Search Japanese corporations by name',
+        description: DESCRIPTION,
+        inputSchema: InputSchema.shape,
+        outputSchema: OutputSchema.shape,
+        _meta: {
+            ui: { resourceUri: 'ui://search-results/mcp-app.html' },
+        },
+        annotations: {
+            title: 'Search Japanese corporations by name',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const input = InputSchema.parse(args);
+        const cursorPayload = decodeCursor(input.cursor);
+        const divide = cursorPayload?.divide ?? 1;
+        const mode = input.match_mode === 'prefix' ? '1' : '2';
+        const target = input.search_target === 'fuzzy' ? '1' : input.search_target === 'exact' ? '2' : '3';
+        deps.logger.info('tool.search_corporate_by_name', {
+            name_length: input.name.length,
+            mode,
+            target,
+            prefecture: input.prefecture ?? 'any',
+            divide,
+        });
+        const apiResult = await deps.ntaClient.searchByName({
+            name: input.name,
+            mode,
+            target,
+            ...(input.prefecture !== undefined && { address: input.prefecture }),
+            ...(input.kind !== undefined && input.kind.length > 0 && { kind: input.kind.join(',') }),
+            change: input.include_history ? '1' : '0',
+            close: input.include_closed ? '1' : '0',
+            divide,
+        });
+        if (Result.isErr(apiResult)) {
+            const err = apiResult.error;
+            deps.logger.error('tool.search_corporate_by_name.api_error', {
+                code: err.code,
+                httpStatus: err.httpStatus,
+                ntaErrorCode: err.ntaErrorCode,
+            });
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: {
+                                code: err.code,
+                                message: err.message,
+                                httpStatus: err.httpStatus,
+                                guidance: err.httpStatus === 400
+                                    ? '検索結果が多すぎる可能性があります。prefecture や kind で絞り込んでください。'
+                                    : err.httpStatus === 403
+                                        ? 'レート制限中。しばらく待ってから再試行してください。'
+                                        : undefined,
+                            },
+                            attribution: buildAttribution(),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        const parsed = apiResult.value;
+        const queryKey = JSON.stringify([
+            input.name,
+            mode,
+            target,
+            input.prefecture,
+            input.kind,
+            input.include_history,
+            input.include_closed,
+        ]);
+        const nextCursor = computeNextCursor(parsed.header.divideNumber, parsed.header.divideSize, queryKey);
+        const output = {
+            total: parsed.header.count,
+            page_number: parsed.header.divideNumber,
+            page_size: parsed.header.divideSize,
+            corporations: parsed.corporations,
+            next_cursor: nextCursor,
+            last_update_date: parsed.header.lastUpdateDate,
+            attribution: buildAttribution(),
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=search-by-name.js.map

package/dist/tools/search-by-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-by-name.js","sourceRoot":"","sources":["../../src/tools/search-by-name.ts"],"names":[],"mappings":"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"}

package/dist/tools/validate-check-digit.d.ts

@@ -0,0 +1,35 @@
+/**
+ * T3: validate_corporate_number
+ * 法人番号のチェックデジットをローカル検証 (API 呼出なし、レート制限消費なし)
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 §2.1.3 (13桁・半角数字・チェックデジット付き)
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare const InputSchema: z.ZodObject<{
+    corporate_number: z.ZodString;
+}, z.core.$strict>;
+declare const OutputSchema: z.ZodObject<{
+    is_valid: z.ZodBoolean;
+    normalized: z.ZodNullable<z.ZodString>;
+    reason: z.ZodEnum<{
+        not_13_digits: "not_13_digits";
+        check_digit_mismatch: "check_digit_mismatch";
+        invalid_characters: "invalid_characters";
+        first_digit_zero: "first_digit_zero";
+        ok: "ok";
+    }>;
+    guidance: z.ZodString;
+    attribution: z.ZodObject<{
+        data_source: z.ZodString;
+        service_disclaimer: z.ZodString;
+        license: z.ZodLiteral<"公共データ利用規約 第1.0版">;
+        api_version: z.ZodLiteral<"Ver.4.0">;
+        accessed_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+export type ValidateCheckDigitInput = z.infer<typeof InputSchema>;
+export type ValidateCheckDigitOutput = z.infer<typeof OutputSchema>;
+export declare function registerValidateCheckDigitTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=validate-check-digit.d.ts.map

package/dist/tools/validate-check-digit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-check-digit.d.ts","sourceRoot":"","sources":["../../src/tools/validate-check-digit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,QAAA,MAAM,WAAW;;kBASN,CAAC;AAEZ,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;kBAkBP,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAClE,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAmBpE,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA4DtE"}

package/dist/tools/validate-check-digit.js

@@ -0,0 +1,105 @@
+/**
+ * T3: validate_corporate_number
+ * 法人番号のチェックデジットをローカル検証 (API 呼出なし、レート制限消費なし)
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 §2.1.3 (13桁・半角数字・チェックデジット付き)
+ */
+import { z } from 'zod';
+import { AttributionSchema, buildAttribution } from '../domain/corporate-number.js';
+import { normalizeAndValidateCorporateNumber } from '../domain/check-digit.js';
+const InputSchema = z
+    .object({
+    corporate_number: z
+        .string()
+        .min(1)
+        .describe('検証する文字列。ハイフン・全角数字・前後の空白は自動正規化されます。例: "1340-00102-3456" や "１３４０００１０２３４５６" も受け付けます。'),
+})
+    .strict();
+const OutputSchema = z
+    .object({
+    is_valid: z.boolean(),
+    normalized: z
+        .string()
+        .regex(/^\d{13}$/)
+        .nullable()
+        .describe('半角13桁に正規化した法人番号。is_valid=false の場合 null。'),
+    reason: z.enum([
+        'ok',
+        'not_13_digits',
+        'check_digit_mismatch',
+        'invalid_characters',
+        'first_digit_zero',
+    ]),
+    guidance: z.string().describe('エラー時の修正ガイダンス'),
+    attribution: AttributionSchema,
+})
+    .strict();
+const DESCRIPTION = `法人番号 (13桁) のチェックデジットをローカルで検証します。国税庁 API を叩かないため、レート制限を消費しません。高速・無料・オフライン動作。
+
+USE THIS WHEN:
+- 名刺や書類に記載された法人番号が 13桁として妥当かだけ確認したい
+- API 呼出なしで事前バリデーションを実施したい (一括処理・フォーム入力検証)
+- ハイフン・全角数字・空白を含む文字列を正規化したい
+
+DO NOT USE WHEN:
+- 番号から社名・住所を知りたい → lookup_corporate_by_number を使う
+- 表記揺れのある会社名から検索したい → search_corporate_by_name
+
+チェックデジット計算式 (国税庁仕様書 第二編 §2.1.3):
+  c = 9 - ( Σ_{n=1}^{12} (P_n × Q_n) mod 9 )
+  ただし c が 0 のとき c = 9
+  P_n: 12桁基礎番号の右から n 桁目
+  Q_n: n が偶数なら 1、奇数なら 2`;
+export function registerValidateCheckDigitTool(server) {
+    server.registerTool('validate_corporate_number', {
+        title: 'Validate Japanese corporate number check digit (local, no API call)',
+        description: DESCRIPTION,
+        inputSchema: InputSchema.shape,
+        outputSchema: OutputSchema.shape,
+        annotations: {
+            title: 'Validate Japanese corporate number check digit',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        const input = InputSchema.parse(args);
+        const result = normalizeAndValidateCorporateNumber(input.corporate_number);
+        let output;
+        if (result.isValid) {
+            output = {
+                is_valid: true,
+                normalized: result.normalized,
+                reason: 'ok',
+                guidance: '有効な法人番号です / Valid corporate number.',
+                attribution: buildAttribution(),
+            };
+        }
+        else {
+            const guidance = {
+                not_13_digits: '法人番号は 13桁の半角数字です。ハイフン・空白は除去されます。入力長を確認してください。',
+                check_digit_mismatch: 'チェックデジットが一致しません。番号の写し間違いの可能性が高いです。原本をご確認ください。',
+                invalid_characters: '数字以外の文字が含まれています。数字・ハイフン・空白以外を除いてください。',
+                first_digit_zero: '先頭桁 (チェックデジット) が 0 の法人番号は存在しません。入力をご確認ください。',
+            };
+            output = {
+                is_valid: false,
+                normalized: null,
+                reason: result.reason,
+                guidance: guidance[result.reason],
+                attribution: buildAttribution(),
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=validate-check-digit.js.map

package/dist/tools/validate-check-digit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-check-digit.js","sourceRoot":"","sources":["../../src/tools/validate-check-digit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AAE/E,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,mFAAmF,CACpF;CACJ,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,KAAK,CAAC,UAAU,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CAAC,0CAA0C,CAAC;IACvD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;QACb,IAAI;QACJ,eAAe;QACf,sBAAsB;QACtB,oBAAoB;QACpB,kBAAkB;KACnB,CAAC;IACF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC7C,WAAW,EAAE,iBAAiB;CAC/B,CAAC;KACD,MAAM,EAAE,CAAC;AAKZ,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;wBAeI,CAAC;AAEzB,MAAM,UAAU,8BAA8B,CAAC,MAAiB;IAC9D,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B;QACE,KAAK,EAAE,qEAAqE;QAC5E,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,WAAW,CAAC,KAAK;QAC9B,YAAY,EAAE,YAAY,CAAC,KAAK;QAChC,WAAW,EAAE;YACX,KAAK,EAAE,gDAAgD;YACvD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,mCAAmC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAE3E,IAAI,MAAgC,CAAC;QACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,GAAG;gBACP,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,qCAAqC;gBAC/C,WAAW,EAAE,gBAAgB,EAAE;aAChC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAyC;gBACrD,aAAa,EACX,+CAA+C;gBACjD,oBAAoB,EAClB,+CAA+C;gBACjD,kBAAkB,EAChB,uCAAuC;gBACzC,gBAAgB,EACd,6CAA6C;aAChD,CAAC;YACF,MAAM,GAAG;gBACP,QAAQ,EAAE,KAAK;gBACf,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjC,WAAW,EAAE,gBAAgB,EAAE;aAChC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;YACD,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}