Law Scrapper MCP

# Law Scrapper MCP 📜⚖️ A comprehensive Model Context Protocol (MCP) server for accessing and analyzing Polish legal acts from the Sejm API, enabling AI-powered legal research and document analysis.    ## ✨ Features ✅ **Comprehensive legal act access** - Full access to Polish legal acts from Dziennik Ustaw and Monitor Polski ✅ **Advanced search & filtering** - Multi-criteria search by date, type, keywords, publisher, and status ✅ **Detailed document analysis** - Complete metadata, structure, references, and content retrieval ✅ **Date & time utilities** - Specialized date calculations for legal document analysis ✅ **System metadata access** - Keywords, statuses, document types, and institution data ✅ **FastMCP integration** - Built with FastMCP framework following best practices ✅ **Professional documentation** - Extensive examples and clear parameter descriptions ✅ **RESTful API integration** - Direct connection to official Sejm API endpoints ## 📋 Requirements / prerequisites - **Python**: 3.12 or higher - **Package manager**: uv (recommended) or pip - **Internet connection**: Required for accessing Sejm API endpoints - **MCP-compatible tool**: Cursor IDE, Claude Code, or other MCP-supported applications ## 🚀 Installation ### Using uv (recommended) ```bash # Clone the repository git clone https://github.com/numikel/law-scrapper-mcp.git cd law-scrapper-mcp # Install dependencies uv sync ``` ### Using pip ```bash # Clone the repository git clone https://github.com/numikel/law-scrapper-mcp.git cd law-scrapper-mcp # Install dependencies pip install -e . ``` ## ⚙️ Configuration ### MCP server configuration Add the following configuration to your MCP client's configuration file: #### For Cursor IDE (`.cursor/mcp.json`): ```json { "mcpServers": { "law-scrapper-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/numikel/law-scrapper-mcp", "law-scrapper" ], "transport": "stdio" } } } ``` #### For Claude Code: ```bash claude mcp add law-scrapper-mcp uvx '--from' 'git+https://github.com/numikel/law-scrapper-mcp' 'law-scrapper' ``` #### For other MCP tools (`.mcp.json` or `mcp_config.json`): ```json { "mcpServers": { "law-scrapper-mcp": { "command": "uvx", "args": [ "--from", "git+https://github.com/numikel/law-scrapper-mcp", "law-scrapper" ], "transport": "stdio" } } } ``` ## 🎯 Quick start / usage Once configured, you can start using the legal research tools: ### Basic usage examples **Get current date for legal analysis:** > "What is today's date?" **Search for specific legal acts:** > "Find all regulations from 2020 containing 'environment'" **Analyze document structure:** > "Show me the table of contents for act DU/2020/1" **Get comprehensive document details:** > "Give me full information about legal act DU/2020/1280" ### Available tool categories The server provides 14 specialized tools organized in 4 categories: #### 🕒 **Dates & time** (2 tools) - `get_current_date` - Get current date for legal analysis - `calculate_date_offset` - Calculate date ranges for legal periods #### 📚 **System metadata** (6 tools) - `get_legal_keywords` - Access all available search keywords - `get_legal_publishers` - List all legal publishers (DU, MP) - `get_publisher_details` - Detailed publisher information - `get_legal_statuses` - Document status types - `get_legal_types` - Legal document types - `get_legal_institutions` - Involved institutions #### 🔍 **Acts browsing & search** (2 tools) - `search_legal_acts` - Advanced multi-criteria search - `get_publisher_year_acts` - Browse acts by publisher and year #### 📋 **Act details & analysis** (4 tools) - `get_act_comprehensive_details` - Complete document metadata - `get_act_content` - PDF/HTML content retrieval - `get_act_table_of_contents` - Document structure analysis - `get_act_relationships` - Legal references and amendments ## 📁 Project structure ``` law-scrapper-mcp/ ├── app.py # Main MCP server implementation with 14 legal research tools ├── pyproject.toml # Project configuration, dependencies, and CLI scripts ├── uv.lock # Lock file ensuring reproducible builds ├── README.md # Project documentation └── __pycache__/ # Python bytecode cache (generated) ``` ## 🛠️ Development ### Development setup ```bash # Install in development mode uv sync # Run the server directly uv run app.py # Or use the installed script law-scrapper ``` ### Running tests ```bash # Run basic functionality tests 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)}') " ``` ### Code quality The project follows FastMCP best practices: - **Tagged Tools**: All tools have descriptive tags for filtering - **Annotated Parameters**: Every parameter has clear descriptions - **Comprehensive Examples**: Minimum 5 examples per tool - **Professional Documentation**: Detailed docstrings and usage examples ## 🤝 Contributing 1. Fork the repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes using Conventional Commits format 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request ### Development guidelines - Follow FastMCP best practices for tool definitions - Include comprehensive examples and parameter descriptions - Add appropriate tags for tool categorization - Test all new functionality before submitting - Use English for all code comments and documentation ## 📄 License This project is licensed under the MIT License ## 👤 Author **[@numikel](https://github.com/numikel)** --- **Legal disclaimer**: This tool provides access to Polish legal documents for research purposes. Always consult with qualified legal professionals for legal advice and interpretation of laws.