Law Scrapper MCP

🚀 法律抓取器MCP 📜⚖️

法律抓取器MCP是一個全面的模型上下文協議（MCP）服務器，用於從眾議院API訪問和分析波蘭法律法案，支持基於人工智能的法律研究和文檔分析。

✨ 主要特性

• ✅ 全面的法律法案訪問：可全面訪問《法律公報》（Dziennik Ustaw）和《波蘭公報》（Monitor Polski）中的波蘭法律法案。
• ✅ 高級搜索與過濾：支持按日期、類型、關鍵詞、發佈者和狀態進行多標準搜索。
• ✅ 詳細的文檔分析：可檢索完整的元數據、結構、引用和內容。
• ✅ 日期和時間實用工具：提供專門用於法律文檔分析的日期計算功能。
• ✅ 系統元數據訪問：可獲取關鍵詞、狀態、文檔類型和機構數據。
• ✅ FastMCP集成：基於FastMCP框架構建，遵循最佳實踐。
• ✅ 專業文檔：提供豐富的示例和清晰的參數說明。
• ✅ RESTful API集成：可直接連接到官方眾議院API端點。

📋 要求/先決條件

• Python：3.12或更高版本
• 包管理器：推薦使用uv，也可使用pip
• 互聯網連接：訪問眾議院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的完整信息"

可用工具類別

服務器提供14個專業工具，分為4個類別：

🕒 日期和時間（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('服務器導入成功')
funcs = [name for name in dir(app) if name.startswith('get_')]
print(f'可用工具數量: {len(funcs)}')
"

代碼質量

項目遵循FastMCP最佳實踐：

• 標記工具：所有工具都有描述性標籤，便於過濾。
• 參數註釋：每個參數都有清晰的描述。
• 豐富示例：每個工具至少有5個示例。
• 專業文檔：提供詳細的文檔字符串和使用示例。

貢獻

1. 分叉倉庫
2. 創建您的功能分支 (git checkout -b feature/amazing-feature)
3. 使用規範提交格式提交更改
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求

開發指南

• 遵循FastMCP工具定義的最佳實踐。
• 提供豐富的示例和參數說明。
• 為工具分類添加適當的標籤。
• 在提交前測試所有新功能。
• 所有代碼註釋和文檔使用英語。

📄 許可證

本項目採用MIT許可證。

👤 作者

@numikel

法律免責聲明：本工具僅用於研究目的，提供對波蘭法律文檔的訪問。如需法律建議和法律解釋，請始終諮詢合格的法律專業人士。