Ristophonics/MCPLegal

California Legal MCP Server

A Model Context Protocol (MCP) server providing real-time access to California legal resources through web scraping and intelligent search capabilities.

🌟 Features

• Live Data: Real-time web scraping of California Legislative Information
• Comprehensive Coverage: Civil Code, Penal Code, Labor Code, Family Code, and more
• Smart Search: Intelligent keyword mapping to relevant legal sections
• Modern UI: Responsive dashboard with search history and export capabilities
• Robust Fallback: Graceful degradation to mock data when scraping fails
• Framework-Free: Pure HTML, CSS, and JavaScript implementation

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn

Installation

git clone <repository-url>
cd MCPLegal
npm install

Build

npm run build

Run MCP Server

npm start

Run with Web Dashboard

npm run webscrape

Then open: http://localhost:3001/simple-dashboard.html

📊 Web Scraping Demo

Access the interactive demo at: http://localhost:3001/web-scraping-demo.html

🔧 API Usage

MCP Tools Available

• search-california-codes - Search California state codes and statutes
• search-case-law - Search California court cases and decisions
• get-court-info - Get information about California courts
• get-legal-forms - Access California legal forms and templates
• lookup-legal-definitions - Look up California legal term definitions

HTTP API

POST http://localhost:3001/api/tools
Content-Type: application/json

{
  "tool": "search-california-codes",
  "args": {
    "query": "security deposit",
    "section": "1950.5",
    "code": "Civil Code"
  }
}

🎯 Supported Legal Areas

• Landlord-Tenant Law: Security deposits, habitability, eviction, rent control
• Employment Law: Wage laws, labor standards, workplace rights
• Criminal Law: Assault, battery, theft, fraud
• Contract Law: Agreements, breach, damages
• Property Law: Real estate, discrimination, privacy
• Consumer Protection: Fraud, deceptive practices

📁 Project Structure

MCPLegal/
├── src/
│   └── index.ts                     # Main MCP server with web scraping
├── build/
│   └── index.js                     # Compiled MCP server
├── simple-dashboard.html            # Main dashboard interface
├── simple-http-bridge-webscraping.js # HTTP bridge with MCP integration
├── web-scraping-demo.html          # Interactive demo page
├── package.json                    # Project configuration
└── README.md                       # This file

🛠️ Development

Build for Development

npm run dev

Web Scraping Server

npm run webscrape

📄 License

ISC License

🔗 Data Sources

• California Legislative Information: https://leginfo.legislature.ca.gov
• California Courts: https://www.courts.ca.gov
• Fallback to curated mock data when scraping fails

⚖️ Legal Disclaimer

This is not legal advice. This server provides general information about California law for educational purposes only. Always consult with a qualified California attorney for legal matters.

Built with ❤️ using the Model Context Protocol