openedu

OpenEdu MCP Server exposes a comprehensive set of educational search and enrichment tools via the MCP interface. The server aggregates Open Library for books, Wikipedia for articles, a Dictionary module for vocabulary and language support, and arXiv for academic papers, all with educational metadata such as grade levels, subject classifications, and curriculum alignment. You can access the tooling via HTTP at the standard MCP endpoint (POST /mcp) using JSON-RPC style payloads, or interact through the provided stdio interface for direct command-line usage. Typical workflows include searching for educational resources filtered by grade level and subject, retrieving detailed metadata, and obtaining curated recommendations that align with specific curricula and educational value criteria. The server also includes intelligent caching, rate limiting, and usage analytics to support reliable, scalable access in classroom or tooling environments.

Prerequisites:

• Python 3.9 or higher
• pip (comes with Python)
• git (optional, for cloning)

Installation steps:

1. Clone the repository:

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

2. Create and activate a Python environment (optional but recommended):

python -m venv env
# On Windows
.
env\Scripts\activate
# On Unix or macOS
source env/bin/activate

3. Install dependencies:

pip install -r requirements.txt

4. Set up configuration:

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

5. Run the server:

python -m src.main

6. (Optional) Run validation or tests as described in the repo:

python run_validation_tests.py

Development setup (optional):

pip install -r requirements-dev.txt
pytest tests/
pytest tests/test_integration/
pytest tests/test_performance.py

Environment variables:

• OPEN_EDU_API_KEY: If your deployment requires external API authentication, supply the key here.
• CACHE_TTL_SECONDS: Adjust the TTL for cached results to balance freshness with call quotas. Common issues:
• Missing dependencies or Python version mismatches: ensure Python 3.9+ and a clean virtual environment.
• API rate limits: respect quotas by configuring rate limiting in your environment and monitoring usage analytics.
• Environment file missing: copy .env.example to .env and populate required keys before starting. Configuration tips:
• Use the provided .env file to inject API keys and tuning parameters without changing code.
• If you enable multiple data sources, ensure you have valid credentials for each service (Open Library, Wikipedia, arXiv, etc.).