OpenEdu MCP Server

A comprehensive Model Context Protocol (MCP) server designed to provide educational resources and support curriculum planning for educators. This server integrates with multiple educational APIs to provide access to books, articles, definitions, and research papers with intelligent educational filtering and grade-level appropriateness.

🎓 Features

Complete API Integration Suite

• 📚 Open Library Integration: Educational book search, recommendations, and metadata
• 🌐 Wikipedia Integration: Educational article analysis with grade-level filtering
• 📖 Dictionary Integration: Vocabulary analysis and language learning support
• 🔬 arXiv Integration: Academic paper search with educational relevance scoring

Educational Intelligence

• Grade Level Filtering: K-2, 3-5, 6-8, 9-12, College level content
• Subject Classification: Mathematics, Science, ELA, Social Studies, Arts, PE, Technology
• Curriculum Alignment: Common Core, NGSS, State Standards support
• Educational Metadata: Complexity scoring, reading levels, educational value assessment

Performance & Reliability

• Intelligent Caching: SQLite-based caching with TTL support
• Rate Limiting: Built-in rate limiting to respect API quotas
• Usage Analytics: Comprehensive usage tracking and performance metrics
• Error Handling: Robust error handling with educational context preservation

🚀 Quick Start

Prerequisites

• Python 3.9 or higher
• pip package manager

Installation

1. Clone the repository:

git clone https://github.com/Cicatriiz/openedu-mcp.git
cd openedu-mcp

2. Install dependencies:

pip install -r requirements.txt

3. Set up configuration:

cp .env.example .env
# Edit .env with your preferred settings if needed

4. Run the server:

python -m src.main

5. Test the installation:

   python run_validation_tests.py

Development Setup

For development, install additional dependencies:

pip install -r requirements-dev.txt

Run tests:

# Unit tests
pytest tests/

# Integration tests
pytest tests/test_integration/

# Performance tests
pytest tests/test_performance.py

Format code:

black src tests
isort src tests

🛠️ MCP Tools Reference

The Education MCP Server provides 21+ MCP tools across four API integrations:

📚 Open Library Tools (4 tools)

search_educational_books

Search for educational books with grade-level and subject filtering.

search_educational_books(
    query="mathematics",
    subject="Mathematics", 
    grade_level="6-8",
    limit=10
)

get_book_details_by_isbn

Get detailed book information by ISBN with educational metadata.

get_book_details_by_isbn(
    isbn="9780134685991",
    include_cover=True
)

search_books_by_subject

Search books by educational subject with curriculum alignment.

search_books_by_subject(
    subject="Science",
    grade_level="3-5",
    limit=10
)

get_book_recommendations

Get curated book recommendations for specific grade levels.

get_book_recommendations(
    grade_level="9-12",
    subject="Physics",
    limit=5
)

🌐 Wikipedia Tools (5 tools)

search_educational_articles

Search Wikipedia articles with educational filtering and analysis.

search_educational_articles(
    query="photosynthesis",
    grade_level="3-5",
    subject="Science",
    limit=5
)

get_article_summary

Get article summaries with educational metadata and complexity analysis.

get_article_summary(
    title="Solar System",
    include_educational_analysis=True
)

get_article_content

Get full article content with educational enrichment.

get_article_content(
    title="Photosynthesis",
    include_images=True
)

get_featured_article

Get Wikipedia's featured article with educational analysis. ``

... View full README on GitHub