EduChain MCP Server for Claude Desktop

A local MCP (Model Context Protocol) server that integrates the EduChain educational content generation library with Claude Desktop, allowing users to generate MCQs, lesson plans, and flashcards using LLMs like Gemini (via LangChain).

---

🚀 Features

• Multiple Choice Questions Generator
• Lesson Plan Generator
• Flashcard Generator
• Claude-compatible MCP server with FastMCP
• Fully local, secure, and extensible integration

---

🧠 Powered By

• EduChain
• LangChain
• Claude Desktop
• Gemini API (Google)

---

📁 Project Structure

├── server.py # Main MCP server script
├── get_educhain.py # LLM & EduChain config using Gemini
├── tools/
│ ├── generate_mcqs.py
│ ├── generate_lesson_plan.py
│ └── generate_flashcards.py
├── educhain/ # Cloned EduChain repo (not pushed)
├── .env # Contains GEMINI_API_KEY
├── requirements.txt
├── Educhain_McpReport.pdf
├── sample_output.txt # Sample response from all tools/resources
└── README.md

---

## ⚙️ Installation

### 1. Clone and Install EduChain Locally

```bash
git clone https://github.com/satvik314/educhain.git
cd educhain
pip install .

2. Install Required Packages

pip install -r requirements.txt

3. Add your Gemini API key

Create a .env file:

GEMINI_API_KEY=your-gemini-api-key-here

---

🧪 Running the MCP Server

Option 1: Manual Run (for testing)

python server.py

Option 2: Claude-Managed (recommended)

Use the following claude_config.json:

{
  "mcpServers": {
    "educhain": {
      "command": "python",
      "args": ["server.py"],
      "cwd": "C:/absolute/path/to/project",
      "transport": "stdio",
      "env": {
        "DANGEROUSLY_OMIT_AUTH": "true"
      }
    }
  }
}

Save it to:

C:/Users/YOURNAME/.claude/config.json

Then restart Claude Desktop and go to Developer → Restart Server.

🔐 Alternative: Use Auth Tokens for Collaboration

If you're working in a collaborative setup or want stricter control, you can remove the DANGEROUSLY_OMIT_AUTH setting and instead use the auth_token from the MCP Inspector like this:

{
  "mcp_servers": [
    {
      "label": "EduChain Gemini Server",
      "url": "http://127.0.0.1:6277",
      "auth_token": "your-session-token"
    }
  ]
}

This is useful when running the server via:

mcp dev server.py

It connects through the local proxy with full inspection/debug support.

---

🧰 Available Tools & Resources

Name	Type	Description
generate_mcq_tool	Tool	Creates multiple-choice questions for a topic
generate_flashcard_tool	Tool	Generates flashcards for a topic
lesson_plan_resource	Resource	Provides a structured lesson plan

---

🛠 Troubleshooting

• If ports like 6277 or 6274 are in use, kill conflicting processes
• MCP Inspector (via mcp dev server.py) may block Claude — only run one at a time
• Ensure educhain/ is installed but not committed (add it to .gitignore)

---

💡 Contributions

This integration was created as part of an internship assignment to showcase:

• LLM tool integration
• MCP protocol understanding
• Custom tool chaining with LangChain
• Gemini API usage via LangChain adapters

---

📄 License

This repository is for educational and internship use. EduChain is used under its respective open license.

---

🙌 Acknowledgements

• @satvik314 for EduChain
• Anthropic for Claude Desktop
• Google for Gemini

---

📞 Contact

Feel free to reach out via LinkedIn or email for collaboration or queries.