Law Scrapper MCP

🚀 法律スクレイパーMCP 📜⚖️

Sejm APIからポーランドの法令をアクセスし分析するための包括的なモデルコンテキストプロトコル（MCP）サーバーです。AIを活用した法律研究と文書分析を可能にします。

✨ 主な機能

✅ 包括的な法令アクセス - Dziennik Ustaw と Monitor Polski からポーランドの法令に完全にアクセス可能 ✅ 高度な検索とフィルタリング - 日付、タイプ、キーワード、出版社、ステータスによる多条件検索 ✅ 詳細な文書分析 - 完全なメタデータ、構造、参照、およびコンテンツの取得 ✅ 日付と時間のユーティリティ - 法律文書分析用の特殊な日付計算 ✅ システムメタデータアクセス - キーワード、ステータス、文書タイプ、および機関データ ✅ FastMCP統合 - ベストプラクティスに従ってFastMCPフレームワークで構築 ✅ 専門的なドキュメント - 豊富な例と明確なパラメータ説明 ✅ RESTful API統合 - 公式Sejm APIエンドポイントへの直接接続

📋 必要条件

• Python: 3.12以上
• パッケージマネージャー: uv（推奨）またはpip
• インターネット接続: Sejm APIエンドポイントへのアクセスに必要
• MCP互換ツール: Cursor IDE、Claude Code、またはその他のMCP対応アプリケーション

📦 インストール

uvを使用する場合（推奨）

# リポジトリをクローン
git clone https://github.com/numikel/law-scrapper-mcp.git
cd law-scrapper-mcp

# 依存関係をインストール
uv sync

pipを使用する場合

# リポジトリをクローン
git clone https://github.com/numikel/law-scrapper-mcp.git
cd law-scrapper-mcp

# 依存関係をインストール
pip install -e .

🔧 設定

MCPサーバーの設定

MCPクライアントの設定ファイルに以下の設定を追加してください。

Cursor IDEの場合（.cursor/mcp.json）:

{
  "mcpServers": {
    "law-scrapper-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/numikel/law-scrapper-mcp",
        "law-scrapper"
      ],
      "transport": "stdio"
    }
  }
}

Claude Codeの場合:

claude mcp add law-scrapper-mcp uvx '--from' 'git+https://github.com/numikel/law-scrapper-mcp' 'law-scrapper'

その他のMCPツールの場合（.mcp.jsonまたはmcp_config.json）:

{
  "mcpServers": {
    "law-scrapper-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/numikel/law-scrapper-mcp",
        "law-scrapper"
      ],
      "transport": "stdio"
    }
  }
}

🚀 クイックスタート

設定が完了したら、法律研究ツールを使用できます。

基本的な使用例

法律分析用の現在の日付を取得する:

"今日の日付は何ですか？"

特定の法令を検索する:

"2020年の'環境'を含むすべての規制を見つけて"

文書構造を分析する:

"法令DU/2020/1の目次を表示して"

包括的な文書詳細を取得する:

"法令DU/2020/1280の完全な情報を教えて"

利用可能なツールのカテゴリ

サーバーは4つのカテゴリに分類された14の専用ツールを提供します。

🕒 日付と時間 (2つのツール)

• get_current_date - 法律分析用の現在の日付を取得
• calculate_date_offset - 法定期間の日付範囲を計算

📚 システムメタデータ (6つのツール)

• get_legal_keywords - すべての利用可能な検索キーワードにアクセス
• get_legal_publishers - すべての法律出版社（DU、MP）をリスト表示
• get_publisher_details - 出版社の詳細情報
• get_legal_statuses - 文書のステータスタイプ
• get_legal_types - 法律文書のタイプ
• get_legal_institutions - 関係する機関

🔍 法令の閲覧と検索 (2つのツール)

• search_legal_acts - 高度な多条件検索
• get_publisher_year_acts - 出版社と年で法令を閲覧

📋 法令の詳細と分析 (4つのツール)

• get_act_comprehensive_details - 完全な文書メタデータ
• get_act_content - PDF/HTMLコンテンツの取得
• get_act_table_of_contents - 文書構造分析
• get_act_relationships - 法律参照と改正

📁 プロジェクト構造

law-scrapper-mcp/
├── app.py                    # 14の法律研究ツールを持つ主要なMCPサーバーの実装
├── pyproject.toml           # プロジェクトの設定、依存関係、およびCLIスクリプト
├── uv.lock                  # 再現可能なビルドを保証するロックファイル
├── README.md               # プロジェクトのドキュメント
└── __pycache__/            # Pythonバイトコードキャッシュ（生成される）

🛠️ 開発

開発環境のセットアップ

# 開発モードでインストール
uv sync

# サーバーを直接実行
uv run app.py

# またはインストールされたスクリプトを使用
law-scrapper

テストの実行

# 基本機能テストを実行
uv run python -c "
import app
print('Server imports successfully')
funcs = [name for name in dir(app) if name.startswith('get_')]
print(f'Available tools: {len(funcs)}')
"

コード品質

このプロジェクトはFastMCPのベストプラクティスに従っています。

• タグ付きツール: すべてのツールにフィルタリング用の説明的なタグが付けられています。
• 注釈付きパラメータ: すべてのパラメータには明確な説明があります。
• 包括的な例: 各ツールに最低5つの例があります。
• 専門的なドキュメント: 詳細なdocstringと使用例があります。

🤝 コントリビューション

1. リポジトリをフォークする
2. あなたの機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. コミットメッセージをConventional Commits形式でコミットする
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを開く

開発ガイドライン

• ツール定義にFastMCPのベストプラクティスに従ってください。
• 包括的な例とパラメータの説明を含めてください。
• ツールの分類に適切なタグを追加してください。
• 提出する前にすべての新しい機能をテストしてください。
• すべてのコードコメントとドキュメントに英語を使用してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

👤 作者

@numikel

法律上の免責事項: このツールは研究目的でポーランドの法律文書にアクセスするためのものです。法律のアドバイスや解釈については、常に資格のある法律専門家に相談してください。