⚖️ An intelligent German legal QA agent with MCP (Model Context Protocol) integration for accessing comprehensive German federal law database and providing legal analysis.
This German legal agent provides expert legal analysis by intelligently accessing the comprehensive German federal law database through the Model Context Protocol (MCP). It can answer legal questions, explain regulations, analyze legal scenarios, and provide precise legal references by querying the complete German federal law collection in real-time.
- Legal Data Access: Comprehensive access to all German federal laws and regulations (Bundesgesetze und -verordnungen)
- Multi-LLM Support: Works with both local (Ollama) and cloud-based (OpenRouter) language models
- Tool-Calling Architecture: Automatic legal document retrieval without manual intervention
- Real-Time Monitoring: Complete visibility into legal database queries and system operations
- Clean Interface: Filtered chat experience with technical details in separate monitoring panel
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ React UI │ │ LLM Provider │ │ German Law DB │
│ │ │ │ │ │
│ • Chat Interface│◄──►│ • Ollama │◄──►│ • Federal Laws │
│ • Provider Setup│ │ • OpenRouter │ │ • Regulations │
│ • MCP Monitoring│ │ • Tool Calling │ │ • Legal Codes │
└─────────────────┘ └─────────────────┘ └─────────────────┘
▲ ▲ ▲
│ │ │
└───────────────────────┼───────────────────────┘
│
┌─────────────────┐
│ MCP Proxy │
│ │
│ • Protocol Hub │
│ • Data Bridge │
│ • Tool Registry │
└─────────────────┘
- Node.js 18+
- npm or yarn
- (Optional) Ollama for local models
- (Optional) OpenRouter API key for cloud models
- Clone the repository
git clone <repository-url>
cd german-legal-agent- Install dependencies
# Frontend
cd app && npm install
# MCP Server
cd ../server && npm install
# MCP Tools
cd ../mcp-servers/legal-files && npm install- Configure your data source
# Set your German law data directory (use absolute path on your system)
export LEGAL_FILES_ROOT="$(pwd)/data/gesetze"# From project root
./scripts/start-all.sh- Start MCP Proxy Server
cd server
LEGAL_FILES_ROOT="$(pwd)/../data/gesetze" npm start- Start Frontend
cd app
npm run dev- Access the application
- Frontend: http://localhost:5173
- MCP Proxy: http://localhost:8787
- ✅ Intelligent Legal Analysis: Multi-iteration reasoning for complex legal questions
- ✅ Real-Time Legal Data Access: Live querying of German federal law database
- ✅ Multi-Provider Support: Choice between local and cloud-based language models
- ✅ Enhanced Monitoring: Detailed logging of all data operations
- ✅ Clean Chat Interface: Customer-focused view with technical details hidden
- ✅ Tool Call Visualization: See exactly what data is being accessed
- ✅ Parameter Tracking: Monitor search queries and file access patterns
- ✅ Error Handling: Graceful degradation with helpful error messages
- ✅ Iteration Control: Automatic continuation until customer question is fully answered
# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh
# Pull a model
ollama pull qwen3:8b
# Model will be available at localhost:11434- Get API key from OpenRouter
- In the application, select "OpenRouter" provider
- Enter your API key
- Choose a model (e.g.,
anthropic/claude-3.5-sonnet)
The bot can be configured to access various business data sources:
// German Law Database Structure
data/gesetze/
├── a/ // Laws starting with 'A'
│ ├── agg/ // Allgemeines Gleichbehandlungsgesetz
│ │ └── index.md // Full law text in Markdown
│ └── arbzg/ // Arbeitszeitgesetz
├── b/ // Laws starting with 'B'
└── ... // All German federal laws A-ZEmployment Law Question
User: "What are the maximum working hours allowed in Germany?"
Agent: [Accesses Arbeitszeitgesetz] → "According to § 3 ArbZG, the daily working time must not exceed 8 hours. It can be extended to 10 hours if compensated within 6 months or 24 weeks."
Anti-Discrimination Law
User: "What constitutes discrimination based on age under German law?"
Agent: [Searches AGG] → "Under § 1 AGG (Allgemeines Gleichbehandlungsgesetz), age-based discrimination is prohibited. § 10 AGG allows different treatment only if objectively justified by legitimate aims."
Legal Reference Lookup
User: "What does § 823 BGB say about tort liability?"
Agent: [Queries BGB] → "§ 823 BGB establishes the fundamental principle of tort liability: whoever unlawfully and culpably injures another's life, body, health, freedom, property, or similar rights must compensate for damages."
german-legal-agent/
├── app/ # React frontend
│ ├── src/
│ │ ├── components/ # UI components
│ │ ├── lib/ # Core logic
│ │ └── styles/ # CSS styles
├── server/ # MCP proxy server
├── mcp-servers/ # MCP tool implementations
├── data/gesetze/ # German federal law database
└── docs/ # Documentation
# Run tests
npm test
# Type checking
npm run type-check
# Linting
npm run lint
# Build for production
npm run build- Create MCP tool for your data source
- Register tool in MCP server
- Update system prompt with tool descriptions
- Test with sample queries
# Build frontend
cd app && npm run build
# Build server
cd ../server && npm run build
# Deploy to your hosting platformLEGAL_FILES_ROOT="./data/gesetze" # Relative to project root
OPENROUTER_API_KEY="your-api-key"
MCP_SERVER_PORT=8787
FRONTEND_PORT=5173- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- 📖 Documentation: Wiki
- 🐛 Bug Reports: Issues
- 💬 Discussions: Discussions
- 📧 Email: support@example.com
- Model Context Protocol for the integration framework
- Anthropic for MCP development
- React and TypeScript for the frontend
- Ollama for local LLM support
Version: 1.0.0 | Last Updated: December 2024