@sugukuru/mcp-houjin-bangou 0.2.0

package/dist/server.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+/**
+ * @sugukuru/mcp-houjin-bangou - HTTP entrypoint
+ *
+ * Express + StreamableHTTPServerTransport (stateless mode)
+ *
+ * 根拠 / Source:
+ *   MCP 公式 "Streamable HTTP" transport
+ *   Transport WG (Dec 2025) stateless direction
+ *   国税庁 Web-API 仕様書 第一編 §5 (アプリケーションID)
+ */
+import express from 'express';
+import cors from 'cors';
+import helmet from 'helmet';
+import pino from 'pino';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { randomUUID } from 'node:crypto';
+import { getEnv } from './lib/env.js';
+import { createNtaClient } from './api/nta-client.js';
+import { createServer } from './mcp.js';
+import { VERSION } from './version.js';
+export async function bootstrap() {
+    const env = getEnv();
+    const logger = pino({
+        level: env.LOG_LEVEL,
+        redact: {
+            paths: [
+                'req.headers.authorization',
+                'req.headers["x-api-key"]',
+                'req.query.id',
+                'NTA_APPLICATION_ID',
+            ],
+            censor: '***REDACTED***',
+        },
+        formatters: {
+            level: (label) => ({ level: label }),
+        },
+    });
+    const ntaClient = createNtaClient({
+        applicationId: env.NTA_APPLICATION_ID,
+        baseUrl: env.NTA_BASE_URL,
+        timeoutMs: env.NTA_TIMEOUT_MS,
+        rps: env.NTA_RATE_LIMIT_RPS,
+        userAgent: `@sugukuru/mcp-houjin-bangou/${VERSION}`,
+        onBackoff: (waitMs) => {
+            logger.warn({ waitMs }, 'NTA API rate limit hit, backoff applied');
+        },
+    });
+    const app = express();
+    app.disable('x-powered-by');
+    app.use(helmet({
+        contentSecurityPolicy: {
+            useDefaults: false,
+            directives: {
+                defaultSrc: ["'none'"],
+                connectSrc: ["'self'"],
+                baseUri: ["'self'"],
+                formAction: ["'none'"],
+                frameAncestors: ["'none'"],
+            },
+        },
+    }));
+    app.use(cors({ origin: true, credentials: false }));
+    app.use(express.json({ limit: '64kb' }));
+    app.use((req, _res, next) => {
+        req.id = randomUUID();
+        next();
+    });
+    // Health check
+    app.get('/health', (_req, res) => {
+        res.status(200).json({
+            status: 'ok',
+            version: VERSION,
+            nta_api_version: 'Ver.4.0',
+            timestamp: new Date().toISOString(),
+        });
+    });
+    // Server Card (SEP-2127 Draft + Transport WG Dec 2025)
+    app.get('/.well-known/mcp.json', (_req, res) => {
+        res.status(200).json(buildServerCard());
+    });
+    // MCP endpoint
+    app.post('/mcp', async (req, res) => {
+        try {
+            const mcpServer = createServer({ ntaClient });
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined, // stateless mode
+                enableJsonResponse: true,
+            });
+            res.on('close', () => {
+                void transport.close();
+                void mcpServer.close();
+            });
+            await mcpServer.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (err) {
+            logger.error({ err }, 'MCP request handling failed');
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32603, message: 'Internal server error' },
+                    id: null,
+                });
+            }
+        }
+    });
+    // Reject GET /mcp and DELETE /mcp in stateless mode
+    app.get('/mcp', (_req, res) => {
+        res.status(405).json({
+            jsonrpc: '2.0',
+            error: { code: -32000, message: 'Method not allowed (stateless mode, use POST)' },
+            id: null,
+        });
+    });
+    app.delete('/mcp', (_req, res) => {
+        res.status(405).json({
+            jsonrpc: '2.0',
+            error: { code: -32000, message: 'Method not allowed (stateless mode)' },
+            id: null,
+        });
+    });
+    // Generic error handler
+    app.use((err, req, res, _next) => {
+        logger.error({ err, reqId: req.id }, 'unhandled error');
+        if (!res.headersSent) {
+            res.status(500).json({ error: 'internal_error' });
+        }
+    });
+    app.listen(env.PORT, () => {
+        logger.info({
+            port: env.PORT,
+            version: VERSION,
+            nodeEnv: env.NODE_ENV,
+            mcpEndpoint: `http://localhost:${env.PORT}/mcp`,
+            serverCardEndpoint: `http://localhost:${env.PORT}/.well-known/mcp.json`,
+        }, '@sugukuru/mcp-houjin-bangou listening');
+    });
+}
+function buildServerCard() {
+    return {
+        name: '@sugukuru/mcp-houjin-bangou',
+        version: VERSION,
+        description: 'MCP server for Japan National Tax Agency Corporate Number Web-API (Ver.4.0). Read-only, anonymous, full 7-primitive activation.',
+        protocol_version: '2025-11-25',
+        homepage: 'https://github.com/sugukurukabe/mcp-houjin-bangou',
+        transport: {
+            type: 'streamable-http',
+            endpoint: '/mcp',
+            stateless: true,
+        },
+        authentication: {
+            required: false,
+            note: 'Anonymous read-only access. v0.5.0 Hosted edition will add OAuth Client Credentials and Enterprise-Managed Authorization (ID-JAG).',
+        },
+        capabilities: {
+            tools: { listChanged: true },
+            resources: { listChanged: true, subscribe: false },
+            prompts: { listChanged: true },
+            completions: {},
+            logging: {},
+        },
+        primitives: {
+            tools: [
+                'lookup_corporate_by_number',
+                'search_corporate_by_name',
+                'validate_corporate_number',
+                'normalize_company_name',
+                'get_attribution',
+            ],
+            prompts: ['business-card-to-database', 'sales-list-enrichment', 'customer-master-dedup'],
+            resource_templates: ['corp://{corporate_number}'],
+            resources: [
+                'attribution://houjin-bangou',
+                'ui://corporate-card/mcp-app.html',
+                'ui://search-results/mcp-app.html',
+            ],
+        },
+        attribution: {
+            data_source: '国税庁法人番号公表サイト (https://www.houjin-bangou.nta.go.jp/)',
+            license: '公共データ利用規約 第1.0版',
+            api_version: 'Ver.4.0',
+        },
+        maintainer: {
+            name: 'Sugukuru K.K.',
+            email: 'engineering@sugukuru.co.jp',
+            location: 'Kagoshima, Japan',
+        },
+        license: 'MIT',
+        // プロンプトインジェクション防御メタデータ
+        safety: {
+            read_only: true,
+            destructive_operations: [],
+            prompt_injection_mitigations: [
+                'static_tool_descriptions',
+                'no_runtime_schema_mutation',
+                'application_id_only_from_env',
+                'attribution_required_on_all_outputs',
+            ],
+        },
+        specs_referenced: [
+            'MCP 2025-11-25',
+            'SEP-2127 Server Card (Draft)',
+            'SEP-1303 Input Validation as Tool Errors',
+            'SEP-986 Tool Name Format',
+            'RFC 5424 (Logging severity)',
+        ],
+    };
+}
+const isMainModule = import.meta.url === `file://${process.argv[1]}`;
+if (isMainModule) {
+    bootstrap().catch((err) => {
+        process.stderr.write(`bootstrap failed: ${err instanceof Error ? err.stack : String(err)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG;AAEH,OAAO,OAA2D,MAAM,SAAS,CAAC;AAClF,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AACnG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;IAErB,MAAM,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,EAAE,GAAG,CAAC,SAAS;QACpB,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,2BAA2B;gBAC3B,0BAA0B;gBAC1B,cAAc;gBACd,oBAAoB;aACrB;YACD,MAAM,EAAE,gBAAgB;SACzB;QACD,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;SACrC;KACF,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,aAAa,EAAE,GAAG,CAAC,kBAAkB;QACrC,OAAO,EAAE,GAAG,CAAC,YAAY;QACzB,SAAS,EAAE,GAAG,CAAC,cAAc;QAC7B,GAAG,EAAE,GAAG,CAAC,kBAAkB;QAC3B,SAAS,EAAE,+BAA+B,OAAO,EAAE;QACnD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACpB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,yCAAyC,CAAC,CAAC;QACrE,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,GAAG,CAAC,GAAG,CACL,MAAM,CAAC;QACL,qBAAqB,EAAE;YACrB,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE;gBACV,UAAU,EAAE,CAAC,QAAQ,CAAC;gBACtB,UAAU,EAAE,CAAC,QAAQ,CAAC;gBACtB,OAAO,EAAE,CAAC,QAAQ,CAAC;gBACnB,UAAU,EAAE,CAAC,QAAQ,CAAC;gBACtB,cAAc,EAAE,CAAC,QAAQ,CAAC;aAC3B;SACF;KACF,CAAC,CACH,CAAC;IACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACpD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACzB,GAAgC,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC;QACpD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,OAAO;YAChB,eAAe,EAAE,SAAS;YAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,uDAAuD;IACvD,GAAG,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC7C,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,eAAe;IACf,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,IAAI,6BAA6B,CAAC;gBAClD,kBAAkB,EAAE,SAAS,EAAE,iBAAiB;gBAChD,kBAAkB,EAAE,IAAI;aACzB,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;gBACvB,KAAK,SAAS,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC,CAAC,CAAC;YACH,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnC,MAAM,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,6BAA6B,CAAC,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,uBAAuB,EAAE;oBACzD,EAAE,EAAE,IAAI;iBACT,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,oDAAoD;IACpD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC5B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,+CAA+C,EAAE;YACjF,EAAE,EAAE,IAAI;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,qCAAqC,EAAE;YACvE,EAAE,EAAE,IAAI;SACT,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,CAAC,GAAU,EAAE,GAAY,EAAE,GAAa,EAAE,KAAmB,EAAE,EAAE;QACvE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAG,GAAgC,CAAC,EAAE,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACtF,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE;QACxB,MAAM,CAAC,IAAI,CACT;YACE,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,WAAW,EAAE,oBAAoB,GAAG,CAAC,IAAI,MAAM;YAC/C,kBAAkB,EAAE,oBAAoB,GAAG,CAAC,IAAI,uBAAuB;SACxE,EACD,uCAAuC,CACxC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe;IACtB,OAAO;QACL,IAAI,EAAE,6BAA6B;QACnC,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,iIAAiI;QACnI,gBAAgB,EAAE,YAAY;QAC9B,QAAQ,EAAE,mDAAmD;QAC7D,SAAS,EAAE;YACT,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,IAAI;SAChB;QACD,cAAc,EAAE;YACd,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,oIAAoI;SAC3I;QACD,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC5B,SAAS,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE;YAClD,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;YAC9B,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,EAAE;SACZ;QACD,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,4BAA4B;gBAC5B,0BAA0B;gBAC1B,2BAA2B;gBAC3B,wBAAwB;gBACxB,iBAAiB;aAClB;YACD,OAAO,EAAE,CAAC,2BAA2B,EAAE,uBAAuB,EAAE,uBAAuB,CAAC;YACxF,kBAAkB,EAAE,CAAC,2BAA2B,CAAC;YACjD,SAAS,EAAE;gBACT,6BAA6B;gBAC7B,kCAAkC;gBAClC,kCAAkC;aACnC;SACF;QACD,WAAW,EAAE;YACX,WAAW,EAAE,qDAAqD;YAClE,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,SAAS;SACvB;QACD,UAAU,EAAE;YACV,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,4BAA4B;YACnC,QAAQ,EAAE,kBAAkB;SAC7B;QACD,OAAO,EAAE,KAAK;QACd,uBAAuB;QACvB,MAAM,EAAE;YACN,SAAS,EAAE,IAAI;YACf,sBAAsB,EAAE,EAAE;YAC1B,4BAA4B,EAAE;gBAC5B,0BAA0B;gBAC1B,4BAA4B;gBAC5B,8BAA8B;gBAC9B,qCAAqC;aACtC;SACF;QACD,gBAAgB,EAAE;YAChB,gBAAgB;YAChB,8BAA8B;YAC9B,0CAA0C;YAC1C,0BAA0B;YAC1B,6BAA6B;SAC9B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACrE,IAAI,YAAY,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/get-attribution.d.ts

@@ -0,0 +1,25 @@
+/**
+ * T6: get_attribution
+ * 国税庁 Web-API 機能利用規約 別添1 第6条 + 公共データ利用規約 第1.0版 の出典文を返却
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第一編 別添1 第6条 (情報の取得元の明示義務)
+ *   国税庁仕様書 第一編 別添3 公共データ利用規約 第1.0版 (コンテンツ利用)
+ */
+import { z } from 'zod';
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare const OutputSchema: z.ZodObject<{
+    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>;
+    formatted_text: z.ZodString;
+    usage_guidance: z.ZodString;
+}, z.core.$strict>;
+export type GetAttributionOutput = z.infer<typeof OutputSchema>;
+export declare function registerGetAttributionTool(server: McpServer): void;
+export {};
+//# sourceMappingURL=get-attribution.d.ts.map

package/dist/tools/get-attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-attribution.d.ts","sourceRoot":"","sources":["../../src/tools/get-attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAezE,QAAA,MAAM,YAAY;;;;;;;;;;kBAQP,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAgBhE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsFlE"}

package/dist/tools/get-attribution.js

@@ -0,0 +1,120 @@
+/**
+ * T6: get_attribution
+ * 国税庁 Web-API 機能利用規約 別添1 第6条 + 公共データ利用規約 第1.0版 の出典文を返却
+ *
+ * 根拠 / Source:
+ *   国税庁仕様書 第一編 別添1 第6条 (情報の取得元の明示義務)
+ *   国税庁仕様書 第一編 別添3 公共データ利用規約 第1.0版 (コンテンツ利用)
+ */
+import { z } from 'zod';
+import { AttributionSchema, buildAttribution } from '../domain/corporate-number.js';
+const InputSchema = z
+    .object({
+    format: z
+        .enum(['full', 'short', 'citation'])
+        .default('full')
+        .describe('full=完全版 (全5フィールド), short=1行テキスト, citation=「出典: ...」形式の引用文'),
+    language: z.enum(['ja', 'en']).default('ja'),
+})
+    .strict();
+const OutputSchema = z
+    .object({
+    attribution: AttributionSchema,
+    formatted_text: z.string().describe('format パラメータに応じた整形済み文字列'),
+    usage_guidance: z
+        .string()
+        .describe('本 MCP の結果を下流のサービス・画面で表示する際の出典明示ガイダンス'),
+})
+    .strict();
+const DESCRIPTION = `国税庁法人番号公表サイト (Web-API 機能) の公式出典文を返します。本 MCP サーバーから取得した情報を下流のアプリケーション・ドキュメント・プレゼンテーション等で使用する際の明示必須文言を提供。
+
+USE THIS WHEN:
+- MCP から取得した法人情報を自社サービスで表示する前に、正しい出典文を取得したい
+- 利用規約遵守のための指定文言を確認したい
+- 報告書・プレゼン・Web ページに掲載する際の出典クレジットを生成したい
+
+DO NOT USE WHEN:
+- 法人番号や法人名を検索したい → 他の tool を使う (各 tool の出力に既に attribution が含まれる)
+
+根拠:
+  - Web-API 機能利用規約 別添1 第6条: 取得情報をもとにしたサービス提供時の指定文言を明示する義務
+  - 公共データ利用規約 第1.0版 (別添3): 出典の記載 + 加工時の明示`;
+export function registerGetAttributionTool(server) {
+    server.registerTool('get_attribution', {
+        title: 'Get required attribution text for NTA Web-API usage',
+        description: DESCRIPTION,
+        inputSchema: InputSchema.shape,
+        outputSchema: OutputSchema.shape,
+        annotations: {
+            title: 'Get required attribution text for NTA Web-API usage',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async (args) => {
+        const input = InputSchema.parse(args);
+        const attribution = buildAttribution();
+        let formattedText;
+        switch (input.format) {
+            case 'full':
+                formattedText =
+                    input.language === 'ja'
+                        ? [
+                            `出典: ${attribution.data_source}`,
+                            `免責: ${attribution.service_disclaimer}`,
+                            `ライセンス: ${attribution.license}`,
+                            `API バージョン: ${attribution.api_version}`,
+                            `アクセス日時: ${attribution.accessed_at}`,
+                        ].join('\n')
+                        : [
+                            `Source: ${attribution.data_source}`,
+                            `Disclaimer: ${attribution.service_disclaimer}`,
+                            `License: ${attribution.license}`,
+                            `API Version: ${attribution.api_version}`,
+                            `Accessed At: ${attribution.accessed_at}`,
+                        ].join('\n');
+                break;
+            case 'short':
+                formattedText =
+                    input.language === 'ja'
+                        ? '出典: 国税庁法人番号公表サイト (公共データ利用規約 第1.0版)'
+                        : 'Source: NTA Corporate Number Publication Site (Japanese Public Data License v1.0)';
+                break;
+            case 'citation':
+                formattedText =
+                    input.language === 'ja'
+                        ? `出典: ${attribution.data_source}`
+                        : `Source: ${attribution.data_source}`;
+                break;
+        }
+        const guidance = input.language === 'ja'
+            ? [
+                '本 MCP の出力を自社サービスで利用する際は、Web-API 機能利用規約 別添1 第6条に基づき',
+                'サービスのいずれかの箇所に service_disclaimer の文言を明示してください。',
+                'また、公共データ利用規約 第1.0版 別添3 に基づき data_source の出典を記載してください。',
+                '加工利用する場合は「○○を加工して作成」と併記してください。',
+            ].join(' ')
+            : [
+                'When using this MCP output in downstream services, per Article 6 of NTA Web-API Terms Annex 1,',
+                'display the service_disclaimer text somewhere in your service.',
+                'Per Japanese Public Data License v1.0 (Annex 3), cite data_source as the source.',
+                'If modified, annotate as "Created by modifying [data_source]".',
+            ].join(' ');
+        const output = {
+            attribution,
+            formatted_text: formattedText,
+            usage_guidance: guidance,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=get-attribution.js.map

package/dist/tools/get-attribution.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Tool registration orchestrator
+ */
+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';
+export interface ToolDeps {
+    ntaClient: NtaClient;
+    logger: McpLogger;
+}
+export declare function registerAllTools(server: McpServer, deps: ToolDeps): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,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;AAOtD,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAMxE"}

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+/**
+ * Tool registration orchestrator
+ */
+import { registerLookupByNumberTool } from './lookup-by-number.js';
+import { registerSearchByNameTool } from './search-by-name.js';
+import { registerValidateCheckDigitTool } from './validate-check-digit.js';
+import { registerGetAttributionTool } from './get-attribution.js';
+import { registerNormalizeCompanyNameTool } from './normalize-company-name.js';
+export function registerAllTools(server, deps) {
+    registerLookupByNumberTool(server, deps);
+    registerSearchByNameTool(server, deps);
+    registerValidateCheckDigitTool(server);
+    registerGetAttributionTool(server);
+    registerNormalizeCompanyNameTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAO/E,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,IAAc;IAChE,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvC,8BAA8B,CAAC,MAAM,CAAC,CAAC;IACvC,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACnC,gCAAgC,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC"}

package/dist/tools/lookup-by-number.d.ts

@@ -0,0 +1,82 @@
+/**
+ * T1: lookup_corporate_by_number
+ * 13桁の法人番号で法人情報を取得 (最大10件カンマ区切り)
+ *
+ * 根拠 / Source: 国税庁仕様書 第六編 §2, 第二編 §2
+ * エンドポイント: GET /4/num?id=...&number=...&type=02&history=0|1
+ */
+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<{
+    corporate_numbers: z.ZodArray<z.ZodString>;
+    include_history: z.ZodDefault<z.ZodBoolean>;
+    language: z.ZodDefault<z.ZodEnum<{
+        ja: "ja";
+        en: "en";
+    }>>;
+}, z.core.$strict>;
+declare const OutputSchema: z.ZodObject<{
+    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>>;
+    not_found: z.ZodArray<z.ZodString>;
+    invalid_inputs: z.ZodArray<z.ZodObject<{
+        input: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    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 LookupByNumberInput = z.infer<typeof InputSchema>;
+export type LookupByNumberOutput = z.infer<typeof OutputSchema>;
+export declare function registerLookupByNumberTool(server: McpServer, deps: {
+    ntaClient: NtaClient;
+    logger: McpLogger;
+}): void;
+export {};
+//# sourceMappingURL=lookup-by-number.d.ts.map

package/dist/tools/lookup-by-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup-by-number.d.ts","sourceRoot":"","sources":["../../src/tools/lookup-by-number.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;;;;;;;kBAgBN,CAAC;AAEZ,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAcP,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAgBhE,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAChD,IAAI,CAqHN"}

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

@@ -0,0 +1,157 @@
+/**
+ * T1: lookup_corporate_by_number
+ * 13桁の法人番号で法人情報を取得 (最大10件カンマ区切り)
+ *
+ * 根拠 / Source: 国税庁仕様書 第六編 §2, 第二編 §2
+ * エンドポイント: GET /4/num?id=...&number=...&type=02&history=0|1
+ */
+import { z } from 'zod';
+import { AttributionSchema, CorporationSchema, buildAttribution, } from '../domain/corporate-number.js';
+import { normalizeAndValidateCorporateNumber } from '../domain/check-digit.js';
+import { Result } from '../lib/result.js';
+const InputSchema = z
+    .object({
+    corporate_numbers: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(10)
+        .describe('13桁の法人番号 (最大10件)。半角数字必須。ハイフン・空白は自動除去されます。'),
+    include_history: z
+        .boolean()
+        .default(false)
+        .describe('変更履歴 (商号変更・所在地変更等) を含めるか。デフォルト false。'),
+    language: z
+        .enum(['ja', 'en'])
+        .default('ja')
+        .describe('ラベル言語 (住所等のデータ値は API のまま、ラベルのみ切替)。'),
+})
+    .strict();
+const OutputSchema = z
+    .object({
+    corporations: z.array(CorporationSchema),
+    not_found: z.array(z.string()).describe('該当が見つからなかった法人番号のリスト。'),
+    invalid_inputs: z
+        .array(z.object({
+        input: z.string(),
+        reason: z.string(),
+    }))
+        .describe('入力エラーの詳細 (SEP-1303 準拠、ツール実行エラーとして返却)。'),
+    attribution: AttributionSchema,
+})
+    .strict();
+const DESCRIPTION = `法人番号 (13桁) を指定して国税庁公表サイトから法人情報を取得します。最大10件カンマ区切りで一括取得可能。チェックデジット検証をローカルで事前実施し、無効な番号は API を叩かず弾きます。
+
+USE THIS WHEN:
+- ユーザーが法人番号 (13桁の数字、例: 1340001023456) を知っていて、社名・住所・登記日を知りたい
+- 名刺・契約書・請求書に記載された法人番号が有効か確認したい
+- 複数の法人番号を一括で検証・情報取得したい (最大10件)
+
+DO NOT USE WHEN:
+- 会社名しか分からない → search_corporate_by_name を使う
+- 番号が有効かだけ確認したい (API 呼出不要) → validate_corporate_number を使う
+- 表記揺れを含む会社名から検索したい → normalize_company_name で候補化してから search_corporate_by_name
+
+根拠: 国税庁 法人番号 Web-API 仕様書 第六編 §2「法人番号を指定して情報を取得する機能」`;
+export function registerLookupByNumberTool(server, deps) {
+    server.registerTool('lookup_corporate_by_number', {
+        title: 'Lookup Japanese corporation by national corporate number',
+        description: DESCRIPTION,
+        inputSchema: InputSchema.shape,
+        outputSchema: OutputSchema.shape,
+        _meta: {
+            ui: { resourceUri: 'ui://corporate-card/mcp-app.html' },
+        },
+        annotations: {
+            title: 'Lookup Japanese corporation by national corporate number',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        const input = InputSchema.parse(args);
+        const validInputs = [];
+        const invalidInputs = [];
+        for (const raw of input.corporate_numbers) {
+            const result = normalizeAndValidateCorporateNumber(raw);
+            if (result.isValid) {
+                validInputs.push(result.normalized);
+            }
+            else {
+                invalidInputs.push({
+                    input: raw,
+                    reason: result.reason,
+                });
+            }
+        }
+        if (validInputs.length === 0) {
+            const output = {
+                corporations: [],
+                not_found: [],
+                invalid_inputs: invalidInputs,
+                attribution: buildAttribution(),
+            };
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(output, null, 2),
+                    },
+                ],
+                structuredContent: output,
+            };
+        }
+        deps.logger.info('tool.lookup_corporate_by_number', {
+            count: validInputs.length,
+            include_history: input.include_history,
+        });
+        const apiResult = await deps.ntaClient.lookupByNumber({
+            numbers: validInputs,
+            history: input.include_history ? '1' : '0',
+        });
+        if (Result.isErr(apiResult)) {
+            const err = apiResult.error;
+            deps.logger.error('tool.lookup_corporate_by_number.api_error', {
+                code: err.code,
+                httpStatus: err.httpStatus,
+                message: err.message,
+            });
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: {
+                                code: err.code,
+                                message: err.message,
+                                httpStatus: err.httpStatus,
+                            },
+                            attribution: buildAttribution(),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        const parsed = apiResult.value;
+        const foundNumbers = new Set(parsed.corporations.map((c) => c.corporate_number));
+        const notFound = validInputs.filter((n) => !foundNumbers.has(n));
+        const output = {
+            corporations: parsed.corporations,
+            not_found: notFound,
+            invalid_inputs: invalidInputs,
+            attribution: buildAttribution(),
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output, null, 2),
+                },
+            ],
+            structuredContent: output,
+        };
+    });
+}
+//# sourceMappingURL=lookup-by-number.js.map