Skip to main content
Glama
razvan1326

Academiadepolitie.com MCP Server

by razvan1326
README.md
# Academiadepolitie.com MCP Remote Server

A Remote Model Context Protocol (MCP) server for Academiadepolitie.com - Romania's leading educational platform for police academy entrance exam preparation. Supporting over **50,000 students** with AI-powered tutoring and personalized learning analytics.

## 🚀 What is Remote MCP?

Unlike Local MCP servers that run on your machine, this Remote MCP server runs on dedicated infrastructure and uses HTTP/SSE transport with OAuth 2.1 authentication. This enables:
- **Scalable access** for multiple users
- **Secure authentication** with your Academiadepolitie.com account  
- **Real-time data** directly from the platform
- **Production-grade reliability**

## 🎓 Educational Platform

### Subjects Covered (20 Active Categories)

#### Core Legal Studies
- **Criminal Law - General Part** (Drept Penal - Partea Generală) - Fundamental concepts, legal principles
- **Criminal Law - Special Part** (Drept Penal - Partea Specială) - Specific crimes, infractions, penalties  
- **Criminal Procedure Law** (Drept Procesual Penal) - Court procedures, evidence, investigation
- **Constitutional Law** (Drept Constituțional) - Romanian constitution, state organization
- **General Theory of Law** (Teoria Generală a Dreptului) - Legal concepts, sources of law

#### MAI Specialized Legislation  
- **MAI Legislation** (Legislația MAI) - Ministry of Internal Affairs specific laws
- **Information Security** (Protecția Informațiilor Clasificate) - Classified information protocols
- **GDPR** - Data protection regulation compliance

#### General Education & Skills
- **Romanian History** (Istoria Românilor) - National history, key events
- **Languages** - Romanian, English, French, German proficiency
- **Mathematics & Physics** - Quantitative reasoning and applications
- **Logical Reasoning** (Raționament Logic) - Critical thinking, formal logic
- **Civic Education** (Ed. Civică) - Citizenship, democratic principles

#### Practical Training
- **Psychology** (Psihologic) - Psychological evaluation, behavioral assessment
- **Applied Training** (Traseu Aplicativ) - Practical exercises, real scenarios

### Key Features
- 🔍 **Comprehensive learning progress analysis**
- 📚 **Fuzzy search across 5,000+ educational articles**
- 🧠 **Personalized AI-generated quizzes and study tools**
- 👥 **Peer collaboration and challenge systems**
- 📊 **Detailed performance analytics and gap identification**

## 🎯 Who Benefits from This MCP Server

### Primary Users: MAI Institution Admission Candidates
Students preparing for entrance exams to Romania's Ministry of Internal Affairs educational institutions:

#### **Police Academy & Officer Programs**
- **Police Academy** (Academia de Politie) - Bachelor's degree officer training
- **Professional Master's Program** (Master Profesional Academia de Politie) - Advanced law enforcement leadership
- **Firefighters Program** (Pompieri Academia de Politie) - Fire safety and emergency response specialization

#### **Police Agent Schools**
- **Police Agent School Campina** - Regional agent training program
- **Police Agent School Cluj-Napoca** - Northern region agent training

#### **Specialized Law Enforcement**
- **Border Police School Oradea** - Border control and frontier management

#### **Gendarmerie Forces**
- **Military Gendarmerie School Dragasani** - NCO and specialized training
- **Military Gendarmerie School Falticeni** - Regional NCO program

#### **Penitentiary System**
- **ANP Targu Ocna** - Prison administration and corrections training

### Secondary Users
- **Educational Institutions** - AI-enhanced tutoring for law enforcement curricula
- **Study Groups** - Collaborative learning with peer matching and challenges  
- **Tutors & Instructors** - Personalized learning analytics and progress tracking
- **Career Professionals** - Continuing education and skill development
- **Researchers** - Educational data analysis and learning pattern insights

*Supporting **30,000+ students** across all MAI educational institutions*

## 🔧 Claude Desktop Configuration

### Remote MCP Setup (Recommended)

Add the following configuration to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "academiadepolitie-remote": {
      "transport": {
        "type": "http",
        "url": "https://mcp.academiadepolitie.com:8443/mcp"
      }
    }
  }
}
```

### Setup Steps

1. **Access the Remote Server**: Visit https://mcp.academiadepolitie.com:8443
2. **OAuth Authentication**: Log in with your Academiadepolitie.com account
3. **Claude Integration**: The server will guide you through connecting with Claude
4. **Start Using**: Access all MCP tools directly from Claude Desktop or Claude Web

## 🔐 Authentication

This server uses **OAuth 2.1 with PKCE** for secure authentication:
- No need to manually manage tokens
- Secure browser-based login flow
- Automatic token refresh
- Rate limiting and CORS protection

## 🛠️ Available MCP Tools

Once connected, you'll have access to:

### `get_student_data`
- Retrieve comprehensive student performance analytics
- Learning progress tracking and behavioral profiling
- Gap analysis and peer matching for collaboration
- Strengths and weaknesses identification across all subjects
- Filter by institution, admission year, or geographic region

### `search_articles`
- Fuzzy search across 5,000+ educational articles and lessons
- Advanced filtering by subject categories and difficulty levels
- Relevance scoring and intelligent content recommendations
- Search across all 20 active subject categories

### `get_article_content`
- Access detailed lesson content with smart pagination (5,000 words/page)
- Progressive learning with reading tracking
- Rich media support for enhanced understanding
- Structured content delivery optimized for study sessions

### `add_note`
- Create and manage personalized study notes
- Link notes to specific topics and lessons
- Collaborative note sharing with study groups
- AI-enhanced note organization and categorization

### `send_challenge`
- Create peer challenges for competitive learning
- Customize quiz difficulty and question count (5-30 questions)
- Gamified learning experiences with performance tracking
- Subject-specific competitions across all MAI curriculum areas

### `update_reading_progress`
- Track reading completion with precise progress metrics (0-100%)
- Adaptive learning paths based on comprehension levels
- Page-by-page progress synchronization
- Intelligent content recommendation based on reading patterns

### `save_generated_quiz`
- Save AI-generated quizzes directly to the platform
- Generate up to 10 questions per quiz session
- Multiple-choice format with detailed explanations
- Subject categorization for organized quiz libraries

## 🌐 Server Infrastructure

- **Production URL**: https://mcp.academiadepolitie.com:8443
- **Protocol**: HTTP/SSE with OAuth 2.1
- **Uptime**: 99.9%+ availability
- **Support**: Both Claude Desktop and Claude Web

## 📋 System Requirements

- Claude Desktop (latest version) or Claude Web access
- Internet connection for OAuth authentication
- Active Academiadepolitie.com account

## 🤝 Support

- **Documentation**: Visit the server URL for interactive docs
- **Issues**: Create an issue in this repository
- **Platform Support**: Contact support@academiadepolitie.com

## 📄 License

MIT License - see LICENSE file for details.

---

**🎯 Transform your Admission Exam preparation with AI-powered learning tools - connect your Academiadepolitie.com knowledge to Claude's intelligence!**