自适应AI辅导MCP服务

Tutor MCP

Learn throughout your life. Grow through learning communities.

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

Description

Tutor MCP is an open-source MCP engine for adaptive learning, self-learning and personalized AI tutoring. Built on the Model Context Protocol, it brings course creation, a structured learning path and ongoing tutoring into your AI assistant. Choose a subject and a goal — from conversational Spanish to backend engineering — and build a course that evolves with your progress.

Build a learning community with Tutor ACP. The Windows client connects Codex or Claude to your institution's learning service. Members find shared programmes in one catalogue, learn at their own pace, and return to their conversations and progress. Owners manage membership and access; authors and authorised trainers maintain programmes from the same application.

• Share programmes within an institution. Publish to all institution members or invite named recipients. Contributions follow owner review unless publication without prior review is authorised for that programme. Sharing a personal programme copies its design while keeping conversations and private progress separate.
• Learn and manage from one desktop client. Conversation and Formations bring together tutoring, the programme library, manual or AI-assisted editing, and progress. Dedicated account and settings pages cover agents, institution, members and reading preferences.
• Build a curriculum on any subject. Your AI maps the subject into a skill graph with concepts, prerequisites and goals. Tutor validates and versions that graph as your course develops.
• Follow a guided learning journey. Diagnose your starting point, work through personalized lessons and exercises, revisit weak areas, and test your ability to apply what you learn.
• Get ongoing, personalized guidance. Knowledge estimates, review dates, misconceptions and session memory shape the next activity, across conversations.
• See the evidence behind your progress. Inspect why an activity was recommended and distinguish estimated knowledge, retained learning and demonstrated skills.

Generative teaching. Deterministic pedagogy. This is Tutor's defining engineering choice: the AI creates and explains; a persistent, auditable engine governs progression. Bayesian Knowledge Tracing (BKT), FSRS spaced repetition, prerequisite rules and assessment evidence drive what to learn, practice or revisit next. Narrative memory gives the tutor the context to make that guidance personal.

Your learning engine travels across AI clients. Use Claude Code, Claude Desktop, ChatGPT, Hermes, Pi (with an MCP extension), Gemini CLI, Le Chat and other compatible MCP clients. Keep the same learning history by connecting to the same Tutor installation, locally over stdio or remotely over HTTPS/OAuth. See the client guide.

Demo

A real first session, running locally over stdio in Claude Code. Tutor maps Go backend development into an 18-concept skill graph, diagnoses what transfers from the learner's Python background, then refuses the Feynman and transfer probes because the mastery estimate sits at 0.33 against a routing threshold of 0.85. Two practice reps later the estimate clears the threshold, the transfer probe runs on an unseen debugging scenario, and the outcome is recorded against the frozen rubric rather than asserted.

Installation

For an institution or learning community, start with Tutor ACP 0.0.3 for Windows x64. Codex and Claude adapters and their Node.js runtime are included. In Connection and tools, connect to your institution’s Tutor service, choose your AI agent and configure its MCP permissions. The desktop client guide covers setup, identities and backups, native Windows and WSL2.

The client offers French/English, light/dark/system themes and adjustable reading settings saved per account. MCP tool permissions can be remembered across conversations and restarts for the selected account, server and agent, and changed in Settings. The server controls access and progress; published programmes retain their versions for enrolled learners until an explicit migration.

Version 0.0.3 brings a frameless window with custom controls, refined spacing and typography, and a single connection screen. It retains the Tutor-MCP graphic charter and bundled Inter and JetBrains Mono fonts. Ctrl+K opens the command palette to find a conversation, navigate to settings or change the theme from the keyboard.

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+; install v0.7.2 for the current server and the ACP client 0.0.3. See installation details for installers, service configuration and backups.

Quickstart

1. Get the binary

For the institutional desktop experience, install Tutor ACP for Windows. Your organization provides the Tutor server; administrators can follow the institutional setup using the server release.

For local use or development, build the MCP server from source with Git and Go 1.26.10 or a newer patched release:

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

In Tutor ACP, select Codex or Claude and connect your provider account. In the institution settings, enter your institution's address and connect with an authorised Tutor identity. The client guide explains identity creation, encrypted backups and account recovery. Provider access and any associated costs are separate from Tutor.

For a local MCP 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

In Tutor ACP, open Formations to choose a programme from your institution's catalogue, or start a personal programme in Conversation when your institution allows it:

I want to learn Go.

The programme is saved from the first exchange and can be resumed later. Personal learning starts directly in the conversation. If setup is incomplete, the message is kept as À envoyer (“To send”) until the connection is ready.

In another MCP client, ask:

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.