e-Gov Law MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@e-Gov Law MCP Server 民法192条の条文を教えてください"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
e-Gov Law MCP Server v2 🏛️⚖️
Ultra Smart & Efficient - 日本政府e-Gov法令APIのための高性能Model Context Protocol (MCP) サーバー
🚀 v2の特徴: FastMCP準拠、Windows完全対応、58%コード削減、3層キャッシュ最適化、エンタープライズセキュリティ
✨ 主な特徴
🎯 インテリジェント法律検索
16基本法直接マッピング: 六法 + 現代重要法への瞬時アクセス
20略称自動変換: 道交法→道路交通法、労基法→労働基準法
複雑パターン対応: 「第325条の3」「第9条第2項第1号」等
4段階条文抽出: コンテンツスコアリングによる高精度抽出
⚡ ハイパフォーマンス
3層LRUキャッシュ: 法律検索(2h)、法律内容(1h)、条文(30m)
並行処理最適化: 50リクエスト/5.27秒の高速レスポンス
メモリ監視: psutil統合、自動クリーンアップ(512MB制限)
バッチ処理: 最大200件の一括検索対応
🛡️ エンタープライズセキュリティ
インジェクション防止: SQL、XSS、JNDI、コード実行を完全ブロック
入力検証: 長さ制限、特殊文字フィルタリング
API保護: レート制限、403 Forbidden応答
エラーマスキング: 内部情報漏洩防止
🌐 クロスプラットフォーム
Windows完全対応: psutilオプション、パス互換性
FastMCP準拠: Context logging、ToolError例外、自動シリアライゼーション
柔軟設定: YAML設定ファイル、プロンプト外部化
Related MCP server: Houki e-Gov MCP Server
🛠️ 8つの高機能MCPツール
ツール | 機能 | 特徴 |
| 条文検索 | AI駆動パターンマッチング、漢数字対応 |
| 法律検索 | フィルタリング、ページネーション |
| キーワード検索 | フルテキスト検索、ハイライト |
| 法律全文取得 | サイズ制限対応(800KB)、XML/JSON |
| バッチ検索 | 最大200件、パフォーマンス統計 |
| キャッシュ最適化 | 頻出法律の事前読み込み |
| 監視 | リアルタイムパフォーマンス監視 |
| メンテナンス | 粒度別キャッシュ管理 |
📊 対応法令
🚀 高速アクセス対応(直接マッピング済み)
六法
憲法(昭和二十一年憲法)
民法(明治二十九年法律第八十九号)
刑法(明治四十年法律第四十五号)
商法(昭和二十三年法律第二十五号)
民事訴訟法(平成八年法律第百九号)
刑事訴訟法(昭和二十三年法律第百三十一号)
現代重要法
会社法、労働基準法、所得税法、法人税法
著作権法、特許法、道路交通法、建築基準法
独占禁止法、消費者契約法、特定受託事業者取引適正化法
🔍 略称検索対応
道交法 → 道路交通法 労基法 → 労働基準法
独禁法 → 独占禁止法 消契法 → 消費者契約法
著作権 → 著作権法 特許 → 特許法
税法 → 所得税法 労働法 → 労働基準法📈 実証された性能
🏆 テスト結果(40+テスト、65%カバレッジ)
✅ 機能テスト: 全ツール、エッジケース、境界値
✅ セキュリティテスト: インジェクション攻撃、不正ペイロード
✅ パフォーマンステスト: 並行性50/50成功、5.27秒
✅ 統合テスト: FastMCP機能、Windows互換性
📊 パフォーマンス指標
並行処理: 50リクエスト同時処理 → 100%成功
キャッシュヒット率: 主要法律で90%以上
レスポンス時間: 直接マッピング法律 < 1秒
メモリ効率: 512MB制限内で安定動作
🚀 クイックスタート
前提条件
uvをインストール:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"インストール
# リポジトリをクローン
git clone https://github.com/ryoooo/e-gov-law-mcp.git
cd e-gov-law-mcp
# 依存関係をインストール
uv sync
# パフォーマンス監視を有効にする場合(オプション)
uv add psutilClaude Desktop設定
設定ファイルの場所:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonLinux:
~/.config/claude/claude_desktop_config.json
設定例:
{
"mcpServers": {
"e-gov-law": {
"command": "uv",
"args": [
"run",
"--directory",
"/path/to/e-gov-law-mcp",
"python",
"run_server.py"
]
}
}
}💡 使用例
Claude Desktopでの基本使用
民法192条について詳しく教えて
憲法第9条第2項の条文と解釈を知りたい
会社法325条の3の株主総会決議について
労基法の有給休暇の規定を調べて
道交法の飲酒運転の罰則は?プログラム使用例
import asyncio
from fastmcp import Client
async def search_example():
async with Client(["uv", "run", "python", "src/mcp_server.py"]) as client:
# 民法192条を検索
result = await client.call_tool("find_law_article", {
"law_name": "民法",
"article_number": "192"
})
print(result[0].text)
# バッチ検索
batch_data = json.dumps([
{"law": "民法", "article": "192"},
{"law": "憲法", "article": "9"}
])
batch_result = await client.call_tool("batch_find_articles", {
"law_article_pairs": batch_data
})
asyncio.run(search_example())🔧 開発とテスト
開発環境セットアップ
git clone https://github.com/ryoooo/e-gov-law-mcp.git
cd e-gov-law-mcp
uv sync --devテスト実行
# 全テスト実行(40+テスト)
uv run pytest
# カバレッジ付きテスト
uv run pytest --cov=src
# セキュリティテスト
uv run pytest test_comprehensive_ultra.py::TestSecurityAndRobustness -v
# パフォーマンステスト
uv run pytest test_comprehensive_ultra.py::TestPerformanceAndScalability -v
# FastMCP統合テスト
uv run pytest test_fastmcp_integration.py -vコード品質
# フォーマット
uv run black src/ tests/
# リント
uv run ruff check src/ tests/
# 型チェック
uv run mypy src/⚙️ 設定
環境変数
# e-Gov API設定
export EGOV_API_URL="https://laws.e-gov.go.jp/api/2"
export EGOV_API_TOKEN="" # 通常は不要
# サーバー設定
export MCP_SERVER_NAME="e-Gov Law Server v2"
export LAW_CONFIG_PATH="config/laws.yaml"設定ファイル
config/laws.yaml: 法律マッピング、略称定義prompts/legal_analysis.md: 法的分析指導プロンプト
🏗️ アーキテクチャ
e-Gov Law MCP Server v2
├── 🎯 FastMCP Core (Context logging, ToolError, Auto-serialization)
├── 🔍 Smart Law Lookup (16 basic laws + 20 aliases)
├── ⚡ 3-Tier Cache System (LRU + TTL + Memory monitoring)
├── 🛡️ Security Layer (Injection prevention, Input validation)
├── 🌐 Cross-Platform Support (Windows/Linux/macOS)
└── 📊 Performance Monitoring (Real-time stats, Batch optimization)📝 API詳細
find_law_article
最も重要なツール - 高精度条文検索
await client.call_tool("find_law_article", {
"law_name": "民法", # 法律名(略称可)
"article_number": "325条の3" # 条文番号(複雑パターン対応)
})対応パターン例:
"192"→ 第192条"第192条"→ 第192条"325条の3"→ 第325条の3"第9条第2項"→ 第9条第2項"第9条第2項第1号"→ 第9条第2項第1号
batch_find_articles
高速バッチ処理 - 最大200件の一括検索
batch_data = json.dumps([
{"law": "民法", "article": "192"},
{"law": "憲法", "article": "9"},
{"law": "会社法", "article": "423"}
])
await client.call_tool("batch_find_articles", {
"law_article_pairs": batch_data
})🔧 トラブルシューティング
Windows環境トラブルシューティング
問題: "No module named 'yaml'" エラー
# 解決方法1: uv syncで依存関係をインストール
cd C:\path\to\e-gov-law-mcp
uv sync
# 解決方法2: 手動インストール
pip install PyYAML httpx fastmcp問題: "No module named 'psutil'" 警告
# psutilはオプションのパフォーマンス監視ライブラリ
# インストールしなくても動作します
# パフォーマンス監視を有効にしたい場合
uv add psutil
# または
pip install psutil問題: FastMCPコマンドエラー
# Claude Desktop設定でrun_server.pyを使用
# 依存関係チェック機能付き
"command": "uv",
"args": [
"run",
"--directory",
"C:\\path\\to\\e-gov-law-mcp",
"python",
"run_server.py"
]その他のWindows問題
# パス区切り文字 → pathlibで自動解決
# UTF-8エンコーディング → 明示的指定済み
# メモリ監視 → psutilなしでも動作パフォーマンス最適化
# キャッシュ統計確認
await client.call_tool("get_cache_stats", {})
# 頻出法律をプリフェッチ
await client.call_tool("prefetch_common_laws", {})
# キャッシュクリア(メモリ不足時)
await client.call_tool("clear_cache", {"cache_type": "all"})📚 参考リンク
🤝 貢献
リポジトリをフォーク
機能ブランチを作成:
git checkout -b feature/amazing-feature変更をコミット:
git commit -m 'feat: Add amazing feature'ブランチにプッシュ:
git push origin feature/amazing-featureプルリクエストを作成
貢献ガイドライン
テストカバレッジを維持(65%以上)
セキュリティテストを必須追加
FastMCP仕様準拠を確認
Windows互換性をテスト
📄 ライセンス
MIT License - 詳細は LICENSE ファイルを参照
🙏 謝辞
🚀 Ultra Smart & Efficient e-Gov Law MCP Server v2
日本法令検索の新しいスタンダード
Available Tools
8 toolsbatch_find_articlesB
Batch find multiple law articles efficiently
Args:
law_article_pairs: JSON string with law-article pairs, e.g. '[{"law":"民法","article":"192"},{"law":"憲法","article":"9"}]'
ctx: FastMCP context for logging
Returns:
Dict with batch results and performance stats
Inputs: law_article_pairs (required).
clear_cacheB
Clear specified cache or all caches
Args:
cache_type: Cache type to clear ("all", "law_lookup", "law_content", "article")
ctx: FastMCP context for logging
Returns:
Dict with clear operation results
Inputs: cache_type.
find_law_articleA
Find a specific article in Japanese law (ULTRA SMART & FAST)
Supports 16+ major laws with direct mapping for instant access.
Handles complex patterns like 条の2, 項, 号 automatically.
Args:
law_name: Law name (e.g., "民法", "会社法", "憲法")
article_number: Article number (e.g., "192", "325条の3", "第9条第2項")
ctx: FastMCP context for logging and progress reporting
Returns:
Dict with found article content and legal analysis metadata
Inputs: law_name (required), article_number (required).
get_cache_statsB
Get current cache statistics and performance metrics
Args:
ctx: FastMCP context for logging
Returns:
Dict with detailed cache statistics
Inputs: no named parameters.
get_law_contentA
Get law content (optimized per API spec with size limits)
Args:
law_id: Law ID
law_num: Law number
response_format: "json" or "xml"
elm: Element to retrieve (currently disabled due to API 400 errors)
ctx: FastMCP context for logging
Returns:
Dict with law content. For large laws (>800KB), returns summary with recommendation to use find_law_article for specific articles.
Note:
- elm parameter is currently disabled due to e-Gov API 400 errors
- Large laws like Company Law (会社法) will return a summary instead of full text
- Use find_law_article tool for specific article searches in large laws
Inputs: law_id, law_num, response_format, elm.
prefetch_common_lawsC
Prefetch commonly accessed laws for better performance
Args:
ctx: FastMCP context for logging
Returns:
Dict with prefetch results and cache status
Inputs: no named parameters.
search_lawsB
Search Japanese laws with smart filtering
Args:
law_title: Law title (partial match)
law_type: Law type (Act, CabinetOrder, etc.)
law_num: Law number (partial match)
limit: Maximum results (1-500)
offset: Starting position
ctx: FastMCP context for logging
Returns:
Dict with search results
Inputs: law_title, law_type, law_num, limit, +1 more.
search_laws_by_keywordB
Full-text keyword search in Japanese laws
Args:
keyword: Search keyword (required)
law_type: Law type filter (optional)
limit: Maximum results (1-20)
ctx: FastMCP context for logging
Returns:
Dict with search results
Inputs: keyword (required), law_type, limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools have distinct purposes, but there is some overlap between search_laws and search_laws_by_keyword, which could cause confusion about when to use each. The batch_find_articles and find_law_article tools also serve similar functions but are differentiated by batch vs. single operations, which is reasonably clear.
All tool names follow a consistent snake_case pattern with clear verb_noun structure (e.g., find_law_article, get_cache_stats, search_laws). This consistency makes the toolset predictable and easy to navigate.
With 8 tools, the server is well-scoped for its domain of Japanese law lookup and search. Each tool has a clear role, covering operations like searching, fetching, caching, and batch processing without being overwhelming.
The toolset provides strong coverage for law lookup and search, including single and batch article retrieval, full-text search, and caching utilities. A minor gap is the lack of update or delete operations, but this is reasonable given the domain of static law data.
Maintenance
Related MCP Connectors
Search Japanese statutes via the e-Gov Law API. Free law_search tool.
Japan Law MCP — Japanese national laws & ordinances via the e-Gov Law API.
Resolve, search and verify legal citations against the official sources, with provenance.
Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables searching and retrieving Japanese legal information from the e-Gov Law API, including law searches by keyword, detailed law data retrieval, and revision history tracking.34,033 npm49MIT
- AlicenseAqualityBmaintenanceEnables LLMs to search and retrieve Japanese laws from the e-Gov API v2, including keyword search, article fetching, table of contents, and revision history.7177 npm2MIT
- AlicenseAqualityBmaintenanceSearches and retrieves Japanese national legislation from the official e-Gov API, providing verifiable citations with stable URLs and human-readable references.628 PyPIApache 2.0
- AlicenseAqualityDmaintenanceFull-text search across all ~10,000 current Japanese laws and regulations (official e-Gov data): keyword search, table of contents, and exact article text.3MIT