Learning Assistant MCP Server 🎓

An educational MCP (Model Context Protocol) server that helps developers learn, understand code, and improve their programming skills through AI-powered tools.

Features 🚀

This MCP server provides 8 powerful learning tools:

1. explainConcept - Get simple explanations of programming concepts with examples

2. reviewCode - Get constructive feedback on your code with improvement suggestions

3. suggestBestPractice - Learn industry best practices for any programming task

4. compareApproaches - Compare different solutions and understand tradeoffs

5. generateLearningPath - Get a structured roadmap to learn any technology

6. debugHelper - Understand and fix errors with guided debugging help

7. explainThisCode - Get detailed explanations of how code works

8. quizMe - Test your knowledge with auto-generated practice questions

Related MCP server: Marble MCP Server

Installation 📦

Prerequisites

• Node.js 18.0.0 or higher

• Cursor IDE or any MCP-compatible client

Setup

1. Clone this repository:

git clone https://github.com/YOUR_USERNAME/learning-assistant-mcp.git
cd learning-assistant-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Configure your MCP client (e.g., Cursor IDE):

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "learning-assistant": {
      "command": "node",
      "args": [
        "/absolute/path/to/learning-assistant-mcp/dist/index.js"
      ]
    }
  }
}

Replace /absolute/path/to/learning-assistant-mcp with the actual path where you cloned the repository.

5. Restart Cursor IDE

Usage 💡

Once installed, you can use the tools in Cursor Chat:

Example Prompts

• "Explain what closures are in JavaScript for a beginner"

• "Review this code and suggest improvements"

• "What are the best practices for error handling in React?"

• "Compare REST API vs GraphQL"

• "Create a learning path to master TypeScript"

• "Help me debug this error: Cannot read property 'map' of undefined"

• "Explain what this regex pattern does: /^[a-z]+$/i"

• "Quiz me on JavaScript async/await with 5 questions"

Development 🛠️

# Run in development mode
npm run dev

# Build TypeScript
npm run build

# Run the built server
npm start

Project Structure 📁

learning-assistant-mcp/
├── src/
│   └── index.ts          # Main server implementation
├── dist/                 # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

Tools Reference 📚

explainConcept

Explains programming concepts in beginner-friendly terms.

Parameters:

• concept (string): The concept to explain

• level (optional): "beginner" | "intermediate" | "advanced"

• language (optional): Programming language context

reviewCode

Reviews code and provides constructive feedback.

Parameters:

• code (string): Code to review

• language (string): Programming language

• context (optional): What the code should do

• focusAreas (optional): Array of focus areas

suggestBestPractice

Suggests best practices for programming tasks.

Parameters:

• task (string): The task or area

• technology (optional): Specific framework/library

• currentApproach (optional): Your current approach

compareApproaches

Compares different programming approaches.

Parameters:

• problem (string): The problem to solve

• approaches (array): List of approaches to compare

• criteria (optional): Comparison criteria

generateLearningPath

Creates structured learning roadmaps.

Parameters:

• topic (string): What to learn

• currentLevel: Your current level

• goalLevel: Target proficiency

• timeCommitment (optional): Available time

debugHelper

Helps debug errors and bugs.

Parameters:

• error (string): Error message or bug description

• code (optional): Relevant code

• language (optional): Programming language

• context (optional): What you were doing

explainThisCode

Provides detailed code explanations.

Parameters:

• code (string): Code to explain

• language (string): Programming language

• detailLevel (optional): "overview" | "detailed" | "line-by-line"

quizMe

Generates practice questions.

Parameters:

• topic (string): Topic to quiz on

• difficulty (optional): "easy" | "medium" | "hard"

• questionCount (optional): Number of questions (1-10)

• questionType (optional): Type of questions

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

License 📄

MIT License - see LICENSE file for details

Author ✨

Muhammad Yasir Khan

Support 💬

If you have questions or need help, please open an issue on GitHub.