@shuji-bonji/houki-egov-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shuji-bonji
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,142 @@
+# Houki e-Gov MCP Server
+
+[![CI](https://github.com/shuji-bonji/houki-egov-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/shuji-bonji/houki-egov-mcp/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@shuji-bonji/houki-egov-mcp.svg)](https://www.npmjs.com/package/@shuji-bonji/houki-egov-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/Node-%3E%3D20-brightgreen)](https://nodejs.org/)
+
+日本の法令（憲法・法律・政令・省令・規則）を **e-Gov 法令API v2** 経由で取得する MCP サーバ。
+
+LLM が条文をキーワード・略称・分野で検索したり、特定の条項を Markdown / JSON で取得したり、改正履歴を引いたりできるようにする。
+
+## 提供ツール
+
+| Tool | 用途 |
+|---|---|
+| `search_law` | 法令タイトルでキーワード検索（略称→正式名解決済み） |
+| `get_law` | 条/項/号レベルで本文取得（Markdown / JSON / TOC） |
+| `get_toc` | 目次のみ取得（トークン節約） |
+| `get_law_revisions` | 改正履歴を取得（公布日・施行日・状態） |
+| `search_fulltext` | 全文検索（Phase 2 まで `search_law` にフォールバック） |
+| `resolve_abbreviation` | 略称→正式名解決の診断 |
+| `explain_law_type` | 法令種別（憲法・法律・政令・省令・通達 等）の解説 |
+
+略称辞書（165エントリ・6分野）は [`@shuji-bonji/houki-abbreviations`](https://github.com/shuji-bonji/houki-abbreviations) を内部で利用しています。
+
+## インストール
+
+### Claude Desktop で使う
+
+```json
+// claude_desktop_config.json
+{
+  "mcpServers": {
+    "houki-egov": {
+      "command": "npx",
+      "args": ["-y", "@shuji-bonji/houki-egov-mcp"]
+    }
+  }
+}
+```
+
+### ローカル開発
+
+```bash
+git clone git@github.com:shuji-bonji/houki-egov-mcp.git
+cd houki-egov-mcp
+npm install
+npm run build
+npm test
+```
+
+```json
+// 開発中の動作確認 (.mcp.json)
+{
+  "mcpServers": {
+    "houki-egov-local": {
+      "command": "node",
+      "args": ["/absolute/path/to/houki-egov-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+## 使用例
+
+```
+# LLM への問いかけ → MCP ツール呼び出し
+
+「消費税法30条1項を見せて」
+  → get_law(law_name="消法", article="30", paragraph=1)
+
+「労働基準法の目次を取得」
+  → get_toc(law_name="労基法")
+
+「個人情報保護法の改正履歴を最新5件」
+  → get_law_revisions(law_name="個情法", latest=5)
+
+「電帳法って正式名称なに？」
+  → resolve_abbreviation(abbr="電帳法")
+  → 電子計算機を使用して作成する国税関係帳簿書類の保存方法等の特例に関する法律
+
+「政令と省令の違いは？」
+  → explain_law_type(name="政令")
+```
+
+## 状態
+
+**v0.2.0 (2026-04-27)**
+
+- [x] e-Gov 法令API v2 クライアント（`searchLaws` / `getLawData` / `getLawRevisions`）
+- [x] 法令ツリー走査（条/項/号、目次抽出）+ LRU cache
+- [x] 7ツール本実装
+- [x] 略称辞書を [`@shuji-bonji/houki-abbreviations`](https://github.com/shuji-bonji/houki-abbreviations) ^0.1.0 に分離
+- [x] 法令階層ナレッジ（憲法・法律・政令・省令・規則・条例・告示・訓令・通達・通知 の10種別）
+- [x] Trusted Publisher (OIDC) で publish
+- [x] テストスイート（**50 tests**）
+
+### 計画中
+
+- [ ] Phase 2: `search_fulltext` 本実装（bulkDL + SQLite FTS5）
+- [ ] 漢数字対応（「第三十条」を 30 に変換）
+- [ ] 大規模法令の応答サイズ対策（民法・会社法）
+- [ ] エラーメッセージの LLM 可読化向上
+
+## houki-hub MCP family
+
+houki-egov-mcp は **単体で利用可能**ですが、houki-hub MCP family の一員でもあります。同じ family 内の他 MCP（計画中）と組み合わせると、通達・判例等まで横断的に扱えます。
+
+| パッケージ | 役割 | 状態 |
+|---|---|---|
+| `@shuji-bonji/houki-abbreviations` | 略称辞書（共有ライブラリ） | ✅ v0.1.0 |
+| **`@shuji-bonji/houki-egov-mcp`** | **e-Gov 法令API クライアント（このリポジトリ）** | ✅ v0.2.0 |
+| `@shuji-bonji/houki-nta-mcp` | 国税庁通達・Q&A・タックスアンサー | 計画中 |
+| `@shuji-bonji/houki-mhlw-mcp` | 厚労省通達・通知 | 計画中 |
+| `@shuji-bonji/houki-court-mcp` | 判例（裁判所サイト） | 構想中 |
+| `@shuji-bonji/houki-saiketsu-mcp` | 国税不服審判所裁決 | 構想中 |
+| `@shuji-bonji/houki-hub` | meta-package（一括 install） | 計画中 |
+
+family 全体の設計思想・想定利用シーン・業法との関係は [`docs/DESIGN.md`](docs/DESIGN.md) を参照。
+
+## ドキュメント
+
+- [`docs/LAW-HIERARCHY.md`](docs/LAW-HIERARCHY.md) — 法令種別の階層リファレンス（専門家でない利用者向け）
+- [`docs/USE-CASES.md`](docs/USE-CASES.md) — プロダクト開発の典型ユースケース（電帳法・電子契約・個情法・e-KYC）
+- [`docs/DESIGN.md`](docs/DESIGN.md) — 設計原則・houki-hub family のロードマップ・業法との関係
+- [`DISCLAIMER.md`](DISCLAIMER.md) — 利用上の注意（業法との関係）
+- [`CONTRIBUTING.md`](CONTRIBUTING.md) — 貢献方法
+- [`CHANGELOG.md`](CHANGELOG.md) — リリースノート
+
+## 業法との関係
+
+本MCPは **一次情報の取得・提示のみ** を担います。分析は LLM、判断は利用者（または有資格者）の責任です。**業としての法律事務・税務業務への利用は想定外**です — 詳細は [DISCLAIMER.md](DISCLAIMER.md) 参照。
+
+## デジタル庁公式 MCP との関係
+
+デジタル庁は 2025年12月〜2026年3月の「法令×デジタル」ハッカソンで法令API / MCP のプロトタイプを試行提供した。将来一般公開された場合は、本 MCP のコアを公式 MCP に委譲し、houki-hub family 全体は **公式が手を出さないレイヤ（通達・裁決・判例の横断インデックス、業法対応 Skill 等）** に注力する方針。
+
+## ライセンス
+
+MIT — 個人利用・学習用途のフォーク・改変・再配布を自由に許可します。
+
+ただし、**業としての使用（弁護士法72条・税理士法52条・社労士法27条が定める独占業務）** については想定外であり、作者は一切の責任を負いません。[DISCLAIMER.md](DISCLAIMER.md) を必ずご確認ください。

package/dist/config.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Application Configuration
+ * Centralized configuration management
+ */
+/**
+ * Package information (dynamically loaded from package.json)
+ */
+export declare const PACKAGE_INFO: {
+    readonly name: string;
+    readonly version: string;
+};
+/**
+ * e-Gov Law API v2 endpoints
+ * Spec: https://laws.e-gov.go.jp/api/2/swagger-ui
+ *
+ * NOTE: Query parameters use snake_case (law_title, law_type, ...) — verified 2026-04-23
+ */
+export declare const EGOV_API: {
+    readonly baseUrl: "https://laws.e-gov.go.jp/api/2";
+    /** Search laws by keyword/title/number */
+    readonly laws: "https://laws.e-gov.go.jp/api/2/laws";
+    /** Fetch law body (JSON tree) */
+    readonly lawData: (lawId: string) => string;
+    /** Fetch law revisions list */
+    readonly lawRevisions: (lawId: string) => string;
+    /** Public-facing URL（出典として返却） */
+    readonly publicLawUrl: (lawId: string) => string;
+};
+/**
+ * e-Gov XML bulk download
+ * Used as local-FTS source when HOUKI_HUB_BULK_CACHE=1
+ */
+export declare const EGOV_BULK: {
+    readonly indexUrl: "https://laws.e-gov.go.jp/bulkdownload/";
+    /** Per-category bulk archive URL (populated at fetch time) */
+    readonly categoryBase: "https://laws.e-gov.go.jp/download/";
+};
+/**
+ * HTTP request configuration
+ */
+export declare const HTTP_CONFIG: {
+    readonly userAgent: `${string}/${string}`;
+    readonly timeout: 30000;
+    readonly maxRetries: 3;
+};
+/**
+ * Cache configuration
+ */
+export declare const CACHE_CONFIG: {
+    readonly xml: {
+        readonly maxSize: 20;
+        readonly name: "XMLCache";
+    };
+    readonly parsed: {
+        readonly maxSize: 50;
+        readonly name: "ParseCache";
+    };
+    readonly searchResults: {
+        readonly maxSize: 30;
+        readonly name: "SearchCache";
+    };
+};
+/**
+ * Runtime flags from environment
+ */
+export declare const RUNTIME_FLAGS: {
+    /** Enable local bulk-download cache (SQLite FTS5) */
+    readonly bulkCache: boolean;
+    /** Comma-separated list of extension packages to load */
+    readonly extensions: string[];
+    /** Enable debug logs */
+    readonly debug: boolean;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,eAAO,MAAM,YAAY;;;CAGf,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;IAEnB,0CAA0C;;IAE1C,iCAAiC;8BAChB,MAAM;IACvB,+BAA+B;mCACT,MAAM;IAC5B,iCAAiC;mCACX,MAAM;CACpB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,SAAS;;IAEpB,8DAA8D;;CAEtD,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAIf,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,qDAAqD;;IAErD,yDAAyD;;IAKzD,wBAAwB;;CAEhB,CAAC"}

package/dist/config.js

@@ -0,0 +1,71 @@
+/**
+ * Application Configuration
+ * Centralized configuration management
+ */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const packageJson = require('../package.json');
+/**
+ * Package information (dynamically loaded from package.json)
+ */
+export const PACKAGE_INFO = {
+    name: packageJson.name,
+    version: packageJson.version,
+};
+/**
+ * e-Gov Law API v2 endpoints
+ * Spec: https://laws.e-gov.go.jp/api/2/swagger-ui
+ *
+ * NOTE: Query parameters use snake_case (law_title, law_type, ...) — verified 2026-04-23
+ */
+export const EGOV_API = {
+    baseUrl: 'https://laws.e-gov.go.jp/api/2',
+    /** Search laws by keyword/title/number */
+    laws: 'https://laws.e-gov.go.jp/api/2/laws',
+    /** Fetch law body (JSON tree) */
+    lawData: (lawId) => `https://laws.e-gov.go.jp/api/2/law_data/${lawId}`,
+    /** Fetch law revisions list */
+    lawRevisions: (lawId) => `https://laws.e-gov.go.jp/api/2/law_revisions/${lawId}`,
+    /** Public-facing URL（出典として返却） */
+    publicLawUrl: (lawId) => `https://laws.e-gov.go.jp/law/${lawId}`,
+};
+/**
+ * e-Gov XML bulk download
+ * Used as local-FTS source when HOUKI_HUB_BULK_CACHE=1
+ */
+export const EGOV_BULK = {
+    indexUrl: 'https://laws.e-gov.go.jp/bulkdownload/',
+    /** Per-category bulk archive URL (populated at fetch time) */
+    categoryBase: 'https://laws.e-gov.go.jp/download/',
+};
+/**
+ * HTTP request configuration
+ */
+export const HTTP_CONFIG = {
+    userAgent: `${PACKAGE_INFO.name}/${PACKAGE_INFO.version}`,
+    timeout: 30000,
+    maxRetries: 3,
+};
+/**
+ * Cache configuration
+ */
+export const CACHE_CONFIG = {
+    xml: { maxSize: 20, name: 'XMLCache' },
+    parsed: { maxSize: 50, name: 'ParseCache' },
+    searchResults: { maxSize: 30, name: 'SearchCache' },
+};
+/**
+ * Runtime flags from environment
+ */
+export const RUNTIME_FLAGS = {
+    /** Enable local bulk-download cache (SQLite FTS5) */
+    bulkCache: process.env.HOUKI_HUB_BULK_CACHE === '1',
+    /** Comma-separated list of extension packages to load */
+    extensions: (process.env.HOUKI_HUB_EXTENSIONS ?? '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean),
+    /** Enable debug logs */
+    debug: process.env.DEBUG === '1' || process.env.DEBUG === 'true',
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAsC,CAAC;AAEpF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CACpB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,gCAAgC;IACzC,0CAA0C;IAC1C,IAAI,EAAE,qCAAqC;IAC3C,iCAAiC;IACjC,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,2CAA2C,KAAK,EAAE;IAC9E,+BAA+B;IAC/B,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,gDAAgD,KAAK,EAAE;IACxF,iCAAiC;IACjC,YAAY,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,gCAAgC,KAAK,EAAE;CAChE,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,wCAAwC;IAClD,8DAA8D;IAC9D,YAAY,EAAE,oCAAoC;CAC1C,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,OAAO,EAAE;IACzD,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,CAAC;CACL,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;IACtC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;IAC3C,aAAa,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;CAC3C,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG;IACnD,yDAAyD;IACzD,UAAU,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;SACjD,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC;IAClB,wBAAwB;IACxB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM;CACxD,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared Constants — egov-mcp 固有
+ *
+ * 略称辞書系の定数（LAW_TYPE_CODES / DOMAINS）は @shuji-bonji/houki-abbreviations
+ * から re-export している。Single Source of Truth はそちら。
+ */
+export { LAW_TYPE_CODES, DOMAINS } from '@shuji-bonji/houki-abbreviations';
+export type { LawTypeCode, Domain } from '@shuji-bonji/houki-abbreviations';
+/** 元号コード（e-Gov law_id の先頭1文字） */
+export declare const ERA_CODES: {
+    readonly 1: "Meiji";
+    readonly 2: "Taisho";
+    readonly 3: "Showa";
+    readonly 4: "Heisei";
+    readonly 5: "Reiwa";
+};
+/** 検索結果・取得件数の上限 */
+export declare const LIMITS: {
+    readonly searchDefault: 10;
+    readonly searchMax: 50;
+    readonly fulltextDefault: 10;
+    readonly fulltextMax: 30;
+};
+/** 出力フォーマットの列挙 */
+export declare const OUTPUT_FORMATS: readonly ["markdown", "json", "toc"];
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE5E,iCAAiC;AACjC,eAAO,MAAM,SAAS;;;;;;CAMZ,CAAC;AAEX,mBAAmB;AACnB,eAAO,MAAM,MAAM;;;;;CAKT,CAAC;AAEX,kBAAkB;AAClB,eAAO,MAAM,cAAc,sCAAuC,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,26 @@
+/**
+ * Shared Constants — egov-mcp 固有
+ *
+ * 略称辞書系の定数（LAW_TYPE_CODES / DOMAINS）は @shuji-bonji/houki-abbreviations
+ * から re-export している。Single Source of Truth はそちら。
+ */
+// houki-abbreviations から共有定数を re-export
+export { LAW_TYPE_CODES, DOMAINS } from '@shuji-bonji/houki-abbreviations';
+/** 元号コード（e-Gov law_id の先頭1文字） */
+export const ERA_CODES = {
+    1: 'Meiji',
+    2: 'Taisho',
+    3: 'Showa',
+    4: 'Heisei',
+    5: 'Reiwa',
+};
+/** 検索結果・取得件数の上限 */
+export const LIMITS = {
+    searchDefault: 10,
+    searchMax: 50,
+    fulltextDefault: 10,
+    fulltextMax: 30,
+};
+/** 出力フォーマットの列挙 */
+export const OUTPUT_FORMATS = ['markdown', 'json', 'toc'];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wCAAwC;AACxC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAG3E,iCAAiC;AACjC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;CACF,CAAC;AAEX,mBAAmB;AACnB,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,EAAE;IACb,eAAe,EAAE,EAAE;IACnB,WAAW,EAAE,EAAE;CACP,CAAC;AAEX,kBAAkB;AAClB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC"}

package/dist/formatters/markdown.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 法令を Markdown に整形する。
+ *
+ * 出力規約:
+ * - 見出しは `# 法令名 第X条第Y項第Z号`（指定された粒度に応じて）
+ * - 末尾に必ず出典 URL と取得日時を付ける
+ * - 本MCPは事実情報の提示に徹し、判断・解釈は加えない
+ */
+import type { LawNode } from '../services/egov-client.js';
+import { type TocNode } from '../services/law-tree.js';
+export interface FormatArticleOptions {
+    lawTitle: string;
+    lawId: string;
+    article: LawNode;
+    /** 項を指定して取得する場合 */
+    paragraph?: LawNode;
+    /** 号を指定して取得する場合 */
+    item?: LawNode;
+    retrievedAt: string;
+    at?: string;
+}
+/**
+ * 条文を Markdown に整形する。
+ * paragraph / item 指定があればその範囲だけ出力。
+ */
+export declare function formatArticleMarkdown(opts: FormatArticleOptions): string;
+/**
+ * TOC を Markdown に整形。
+ */
+export declare function formatTocMarkdown(opts: {
+    lawTitle: string;
+    lawId: string;
+    toc: TocNode[];
+    retrievedAt: string;
+    at?: string;
+}): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/formatters/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/formatters/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAiCxE;AAoCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,MAAM,CAWT"}

package/dist/formatters/markdown.js

@@ -0,0 +1,114 @@
+/**
+ * 法令を Markdown に整形する。
+ *
+ * 出力規約:
+ * - 見出しは `# 法令名 第X条第Y項第Z号`（指定された粒度に応じて）
+ * - 末尾に必ず出典 URL と取得日時を付ける
+ * - 本MCPは事実情報の提示に徹し、判断・解釈は加えない
+ */
+import { extractText, findChildByTag, findChildrenByTag, getArticleCaption, } from '../services/law-tree.js';
+import { fromEgovArticleNum } from '../utils/article-num.js';
+import { EGOV_API } from '../config.js';
+/**
+ * 条文を Markdown に整形する。
+ * paragraph / item 指定があればその範囲だけ出力。
+ */
+export function formatArticleMarkdown(opts) {
+    const { lawTitle, lawId, article, paragraph, item, retrievedAt, at } = opts;
+    const articleNum = article.attr?.Num ?? '';
+    const articleNumDisplay = fromEgovArticleNum(articleNum);
+    const caption = getArticleCaption(article);
+    // 見出し
+    let header;
+    if (item && paragraph) {
+        header = `# ${lawTitle} 第${articleNumDisplay}条第${paragraph.attr?.Num}項第${item.attr?.Num}号`;
+    }
+    else if (paragraph) {
+        header = `# ${lawTitle} 第${articleNumDisplay}条第${paragraph.attr?.Num}項`;
+    }
+    else {
+        header = `# ${lawTitle} 第${articleNumDisplay}条`;
+    }
+    // 本文
+    let body;
+    if (item) {
+        body = extractText(item).trim();
+    }
+    else if (paragraph) {
+        body = formatParagraph(paragraph);
+    }
+    else {
+        body = formatArticleBody(article);
+    }
+    const url = EGOV_API.publicLawUrl(lawId);
+    const lines = [header];
+    if (caption)
+        lines.push(caption);
+    lines.push('', body, '', '---', '出典：e-Gov法令検索（デジタル庁）', `URL: ${url}`);
+    if (at)
+        lines.push(`時点: ${at}`);
+    lines.push(`取得日時: ${retrievedAt}`);
+    return lines.join('\n');
+}
+/**
+ * Article 全体を Markdown に整形（全項・全号を含む）。
+ */
+function formatArticleBody(article) {
+    const paragraphs = findChildrenByTag(article, 'Paragraph');
+    return paragraphs.map(formatParagraph).join('\n\n');
+}
+/**
+ * Paragraph を整形。
+ * - 1項のみ → "（項本文）"
+ * - 号があれば箇条書きでぶら下げ
+ */
+function formatParagraph(paragraph) {
+    const paragraphNum = paragraph.attr?.Num ?? '';
+    const sentenceNode = findChildByTag(paragraph, 'ParagraphSentence');
+    const sentenceText = sentenceNode ? extractText(sentenceNode).trim() : '';
+    const items = findChildrenByTag(paragraph, 'Item');
+    const lines = [];
+    // 項番号は 1 のみのとき表示しない（条文単独の場合）
+    if (paragraphNum && paragraphNum !== '1') {
+        lines.push(`**第${paragraphNum}項**`);
+    }
+    if (sentenceText)
+        lines.push(sentenceText);
+    for (const item of items) {
+        const itemNum = item.attr?.Num ?? '';
+        const itemText = extractText(item).trim();
+        lines.push(`${itemNum} ${itemText.replace(/^[一二三四五六七八九十百\d]+\s*/, '')}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * TOC を Markdown に整形。
+ */
+export function formatTocMarkdown(opts) {
+    const { lawTitle, lawId, toc, retrievedAt, at } = opts;
+    const lines = [`# ${lawTitle} — 目次`, ''];
+    for (const node of toc) {
+        appendTocLines(lines, node, 0);
+    }
+    lines.push('', '---', '出典：e-Gov法令検索（デジタル庁）');
+    lines.push(`URL: ${EGOV_API.publicLawUrl(lawId)}`);
+    if (at)
+        lines.push(`時点: ${at}`);
+    lines.push(`取得日時: ${retrievedAt}`);
+    return lines.join('\n');
+}
+function appendTocLines(lines, node, depth) {
+    const indent = '  '.repeat(depth);
+    if (node.tag === 'Article') {
+        const numDisplay = node.num ? fromEgovArticleNum(node.num) : '';
+        const captionPart = node.caption ? ` ${node.caption}` : '';
+        lines.push(`${indent}- 第${numDisplay}条${captionPart}`);
+    }
+    else {
+        lines.push(`${indent}- ${node.title}`);
+        for (const c of node.children) {
+            appendTocLines(lines, c, depth + 1);
+        }
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/formatters/markdown.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * JP-Houki MCP Server
+ * Japanese laws and regulations MCP — thin e-Gov core with pluggable extensions
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * JP-Houki MCP Server
+ * Japanese laws and regulations MCP — thin e-Gov core with pluggable extensions
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { tools } from './tools/definitions.js';
+import { toolHandlers } from './tools/handlers.js';
+import { PACKAGE_INFO } from './config.js';
+import { logger } from './utils/logger.js';
+// Server instance
+const server = new Server({
+    name: PACKAGE_INFO.name,
+    version: PACKAGE_INFO.version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// Execute tool
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        const handler = toolHandlers[name];
+        if (!handler) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        const result = await handler(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: message }, null, 2) }],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('server', `${PACKAGE_INFO.name} v${PACKAGE_INFO.version} started`);
+}
+main().catch((error) => {
+    logger.error('server', 'fatal error', error instanceof Error ? error : new Error(String(error)));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAEnG,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,kBAAkB;AAClB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,OAAO,EAAE,YAAY,CAAC,OAAO;CAC9B,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC5E;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,eAAe;AACf,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC,OAAO,UAAU,CAAC,CAAC;AACjF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}