Tutor MCP

Turn your favorite AI into a tutor that remembers your progress.

Description · Installation · Quickstart · How it works · Documentation · Creator · License

Description

Tutor MCP is an open-source learning engine for AI assistants. Tell your AI what you want to learn — Spanish for travel, Go for backend development, medieval history — and Tutor keeps track of your progress, recommends the next activity and schedules reviews across sessions.

• Learn any topic. Your AI creates explanations and exercises around your goals.
• Keep your learning history. Progress, recurring mistakes and session notes survive the conversation.
• Practice with a purpose. Prerequisites, spaced repetition and learning evidence guide what comes next.
• Understand your progress. Inspect the evidence behind a recommendation and distinguish estimated knowledge from demonstrated skills.

Use the AI client you already know: Claude Code, Claude Desktop, ChatGPT, Hermes, Pi (with an MCP extension), Gemini CLI, Le Chat and other compatible MCP clients. Connect locally over stdio or to your own server over HTTPS/OAuth. See the client guide for connection options and compatibility details.

Installation

Choose where your learning data lives. Every profile uses the same learning engine.

Binaries target Linux, macOS and Windows, on amd64 and arm64. Profiles require v0.6.0+; v0.6.0 is currently a draft, so use the source quickstart below until its public release. See installation details for installers, service configuration and backups.

Quickstart

1. Get the binary

Build the current local-mode implementation with Git and Go 1.26.8+:

git clone --branch main https://github.com/ArnaudGuiovanna/tutor-mcp.git
cd tutor-mcp
go build .

This creates tutor-mcp (tutor-mcp.exe on Windows). Keep its full path for the next step.

2. Connect your AI

For a client using mcpServers JSON, such as Claude Desktop, add this to its MCP configuration and replace command with the binary's full path:

{
  "mcpServers": {
    "tutor": {
      "command": "/absolute/path/to/tutor-mcp",
      "args": ["--local"]
    }
  }
}

On Windows, use a path such as C:/tools/tutor-mcp.exe. Restart your client. It launches Tutor automatically and stores your learning profile in ~/.tutor-mcp/local.

Claude Code, Hermes and other clients have their own setup instructions. ChatGPT and other cloud clients use a VPS profile with a public HTTPS endpoint.

3. Start learning

Use Tutor MCP to help me learn Go for backend development. Find out what I already know, create a learning plan, and guide me through a first 20-minute session. Save my progress when we finish.

Next time: “Resume my Go learning with Tutor MCP.” Connect to the same Tutor installation to continue with the same history.

How it works

Your AI handles the conversation, explanations and exercises. Tutor MCP gives it two persistent layers:

The loop is simple: choose an activity → teach and practice → record the response → update the learning state. The client calls get_next_activity for guidance and record_interaction to save observations. Session notes enrich the next conversation.

BKT estimates knowledge, FSRS schedules reviews, and prerequisite checks keep the path coherent. Decisions are inspectable; their quality depends on the evidence the AI records. See the architecture and diagrams and algorithm guide for the mechanics and limits.

Documentation

Understand and extend Tutor

Installation and configuration map

Creator

Created and maintained by Arnaud Guiovanna — aguiovanna.fr · GitHub.

License

MIT — free to use, modify and distribute, including commercially, with the copyright and license notice preserved.