Manages a Kirundi lesson corpus stored as Markdown files, with tools to list, read, search, write, and delete lessons.
Provides AI-powered Kirundi tutoring and answer grading through the OpenAI API.
Stores learner profile data (level, goals, mistakes) in a SQLite database and exposes tools to get and update it.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@kirundi-brain-mcp Quiz me on greetings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Local-first Kirundi (Rundi) study coach exposed as a FastMCP server. An OpenAI Agents SDK demo attaches over stdio, calls path-jailed Brain tools, and tutors from a Markdown corpus — not from thin air.
Inspired by the course trading/MCP labs and pro patterns like asket-mcp (Brain + profile + gated writes), scoped to Burundi language learning.
demo_agent.py → MCPServerStdio → server.py (FastMCP)
│
┌────────────────────┼────────────────────┐
▼ ▼ ▼
brain/*.md SQLite profile ask / grade
(path jail) (data/) (OpenAI + retrieve)Related MCP server: learn-cli
Tool | Purpose |
| List corpus entries |
| Read a lesson |
| Keyword search in |
| Add/update lesson ( |
| Delete lesson (confirm gated) |
| Learner level, goals, mistakes |
| Retrieve + grounded answer |
| Score a short reply |
| Paths / version / config |
cd 6_mcp/community_contributions/Sama-ndari_kirundi-brain
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # set OPENAI_API_KEYpython server.pyExample Cursor mcp.json fragment (adjust absolute paths):
{
"mcpServers": {
"kirundi-study-brain": {
"command": "python",
"args": ["/ABS/PATH/Sama-ndari_kirundi-brain/server.py"],
"env": {
"OPENAI_API_KEY": "sk-...",
"KIRUNDI_BRAIN_DIR": "/ABS/PATH/Sama-ndari_kirundi-brain/brain",
"KIRUNDI_BRAIN_DATA_DIR": "/ABS/PATH/Sama-ndari_kirundi-brain/data"
}
}
}
}python demo_agent.py "How do I say thank you in Kirundi?"
python demo_agent.py "Quiz me on greetings"Bundled under brain/: greetings, courtesy, numbers, food. Point KIRUNDI_BRAIN_DIR at a larger phrase bank when you have one.
Variable | Role |
| Required for agent demo + |
| Default |
| Corpus root (default: |
| SQLite dir (default: |
Do not commit .env or data/*.sqlite3.
This server cannot be deployed
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Read-only MCP server exposing a user ORANO library to their own AI agent.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
