EDUMCP Education Protocol
EDUMCP is a protocol that integrates the Model Context Protocol (MCP) with applications in the education field, dedicated to achieving seamless interconnection and interoperability among different AI models, educational applications, smart hardware,
What is EDUMCP Education Protocol?
EDUMCP Education Protocol is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to edumcp is a protocol that integrates the model context protocol (mcp) with applications in the education field, dedicated to achieving seamless interconnection and interoperability among different ai ...
EDUMCP is a protocol that integrates the Model Context Protocol (MCP) with applications in the education field, dedicated to achieving seamless interconnection and interoperability among different AI models, educational applications, smart hardware,
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- EDUMCP is a protocol that integrates the Model Context Proto
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx edumcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use EDUMCP Education Protocol
EDUMCP is an educational AI platform protocol that integrates the Model Context Protocol with a microservices architecture designed for educational applications. It enables seamless interconnection between AI models and educational tools through a unified API gateway, supporting story generation, quiz creation, image and video generation, voice synthesis, and adaptive learning pathways. EdTech developers and educators use it to build AI-powered learning experiences that combine multiple AI modalities — text, image, voice, and video — in a single orchestrated platform.
Prerequisites
- Docker and Docker Compose installed for the recommended containerized setup
- Python 3.10+ and pip for local development without Docker
- PostgreSQL and MongoDB database instances (or use the Docker Compose services)
- A JWT secret key for authentication (set in the .env file)
- An MCP-compatible client to connect to the API gateway
Clone the repository
Download the EDUMCP source from GitHub.
git clone https://github.com/aieducations/edumcp.git
cd edumcpCreate the environment configuration file
Create a .env file in the project root with your database credentials and a secure JWT secret key.
POSTGRES_USER=edumcp_user
POSTGRES_PASSWORD=your_secure_password
MONGODB_URI=mongodb://localhost:27017
MONGODB_DB=EDUMCP
SECRET_KEY=your_jwt_secret_key_change_in_productionStart all services with Docker Compose
Launch the full microservices stack including the API gateway, AI services, and databases using Docker Compose.
docker-compose up -dVerify the API gateway is running
Check that the API gateway is responding on port 8000 and that the service documentation is accessible.
curl http://localhost:8000/health
# Open http://localhost:8000/docs for interactive API documentationConfigure your MCP client to connect to the gateway
Point your MCP client at the running API gateway endpoint to start using the educational AI capabilities.
EDUMCP Education Protocol Examples
Client configuration
Configure your MCP client to connect to the EDUMCP API gateway running locally via Docker Compose.
{
"mcpServers": {
"edumcp": {
"command": "python",
"args": ["-m", "edumcp.server"],
"env": {
"MONGODB_URI": "mongodb://localhost:27017",
"MONGODB_DB": "EDUMCP",
"SECRET_KEY": "your_jwt_secret_key"
}
}
}
}Prompts to try
Use these prompts to generate educational content through the EDUMCP platform.
- "Generate an educational story for 8-year-olds about the water cycle with 3 main characters"
- "Create a 10-question quiz on basic algebra for middle school students with difficulty level medium"
- "Generate a voice narration for this story in English for a child audience"
- "Create an image to accompany a lesson about photosynthesis for ages 10-12"
- "Design an adaptive learning pathway for a student who struggles with fractions"Troubleshooting EDUMCP Education Protocol
Docker Compose services fail to start with database connection errors
Ensure the POSTGRES_USER, POSTGRES_PASSWORD, and MONGODB_URI values in your .env file are correct. Wait 10-15 seconds after 'docker-compose up -d' for the databases to initialize before the API services connect. Run 'docker-compose logs' to see detailed error messages.
API gateway returns 401 Unauthorized on all requests
The JWT SECRET_KEY in your .env must match across all services. Regenerate a random secret key (e.g., 'openssl rand -hex 32'), update the .env file, and restart all services with 'docker-compose restart'.
AI content generation requests time out or return 503
AI generation services run on separate ports (8001-8013) and may take time to start. Check service health at http://localhost:800X/health for the specific service. Some AI features may require additional API keys for external model providers — check the service-specific .env documentation.
Frequently Asked Questions about EDUMCP Education Protocol
What is EDUMCP Education Protocol?
EDUMCP Education Protocol is a Model Context Protocol (MCP) server that edumcp is a protocol that integrates the model context protocol (mcp) with applications in the education field, dedicated to achieving seamless interconnection and interoperability among different ai models, educational applications, smart hardware, It connects AI assistants to external tools and data sources through a standardized interface.
How do I install EDUMCP Education Protocol?
Follow the installation instructions on the EDUMCP Education Protocol GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with EDUMCP Education Protocol?
EDUMCP Education Protocol works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is EDUMCP Education Protocol free to use?
Yes, EDUMCP Education Protocol is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
EDUMCP Education Protocol Alternatives — Similar Developer Tools Servers
Looking for alternatives to EDUMCP Education Protocol? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up EDUMCP Education Protocol in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use EDUMCP Education Protocol?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.