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
- Clone the repository:
git clone https://github.com/Cicatriiz/openedu-mcp.git
cd openedu-mcp
- Install dependencies:
pip install -r requirements.txt
- Set up configuration:
cp .env.example .env
# Edit .env with your preferred settings if needed
- Run the server:
python -m src.main
- 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
