Learnbot Mcp

learnbot-mcp

AI chatbot orchestrator — personas, safety-guarded conversations, spoken TTS, an interactive VRM avatar, and structured language lessons (any language, with deep Japanese/JLPT support) — all logged and auditable.

Preview

The webapp is a 12-page control panel (Personas, Chat, Avatar, Lessons, Japanese, Safety, Audit, Compliance, Voices, Demos, Help) - this is the human side of what the MCP tools drive for agents.

| Dashboard | Chat | Japanese | |-----------|------|----------| | | | |

Captured 2026-08-02 by the CUA-NSIS smoke test against the installed app (12 pages, live API data - see docs/screenshots/cua-*.png).

Features

• Personas — define AI characters with backstory, voice, languages, skills, and scheduled proactive messages
• Safety-guarded chat — topic blocking, rate limiting, PII redaction, full conversation audit log
• Interactive VRM avatar (/avatar) — three.js viewer with orbit/zoom, facial expressions, auto-blink, look-at-cursor; served from GET /api/avatar.vrm
• Language-agnostic lessons — AI-generated lesson plans, spaced-repetition vocab quizzes (SM-2), grammar check, graded readers; every tool takes source_lang/target_lang, not just Japanese
• Deep Japanese/JLPT toolset (/japanese) — bundled kanji, JMdict, JLPT vocab (N5–N1), and example-sentence lookups run on local SQLite, no external service required — plus 11 linked practice games (kanji drills, flashcards, karuta, listening) from a separate optional ai-games-collection
• Multi-platform output — speak via TTS (Gemini prosody via speech-mcp, falls back to Windows SAPI5), or send to Discord/Resonite bridges
• 35 MCP tools across personas, conversations, lessons, language tools, safety, and audit — see [docs/TOOLS.md](docs/TOOLS.md)

Quick Install

Drag learnbot-mcp-{version}.mcpb onto Claude Desktop.

See [INSTALL.md](INSTALL.md) for all install paths (drag-and-drop, mcpb CLI, manual config, dev mode) — manual config is what's actually verified working today.

What You Can Do

> "Create a persona named Miko who teaches Japanese, start a chat with her, and quiz me on N5 vocabulary."

> "Show me the VRM avatar with a happy expression and have her say hello."

> "Generate a beginner Spanish lesson on ordering food, then run it in a new conversation."

Documentation

| Doc | Contents | |-----|----------| | [Installation](INSTALL.md) | All install methods, prerequisites | | [Configuration](docs/CONFIGURATION.md) | Env vars, config options | | [Tool Reference](docs/TOOLS.md) | All 35 MCP tools | | [Development](docs/DEVELOPMENT.md) | Contributing, local setup, tests | | [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues | | [Japanese Learning Guide](docs/JAPANESELEARNING.md) | Full-spectrum Japanese learning — four skills, phased workflow, JLPT comparison | | [Distance Learning](docs/DISTANCELEARNING.md) | Paired with classroom-mcp — courses, teaching agents, courseware | | [Arabic → German Integration](docs/INTEGRATION_AR.md) | دليل بالعربية — learn German for Austrian daily life | | [Chatbot Ethics](docs/chatbot-ethics.md) | Addiction, regulation, pseudohuman dynamics |

Requirements

• Claude Desktop (or another MCP client) + Python 3.12+
• Node.js, for the webapp
• Windows for the TTS SAPI5 fallback; core features are OS-agnostic
• Optional: local-llm-mcp or Ollama, for AI-generated lessons/grammar-check/reading passages — the dictionary/kanji/JLPT tools need no LLM at all

License

MIT — see [LICENSE](LICENSE).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: sandraschi
• Source: sandraschi/learnbot-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.