Skip to main content
Glama

Kirundi Study Brain (Week 6 MCP)

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.

Architecture

demo_agent.py  →  MCPServerStdio  →  server.py (FastMCP)
                                         │
                    ┌────────────────────┼────────────────────┐
                    ▼                    ▼                    ▼
              brain/*.md           SQLite profile        ask / grade
              (path jail)          (data/)               (OpenAI + retrieve)

Related MCP server: learn-cli

Tools

Tool

Purpose

brain_list_files

List corpus entries

brain_read_file

Read a lesson

brain_search_notes

Keyword search in .md

brain_write_markdown

Add/update lesson (overwrite gated)

brain_delete_file

Delete lesson (confirm gated)

profile_get / profile_update

Learner level, goals, mistakes

ask_kirundi_tutor

Retrieve + grounded answer

grade_kirundi_answer

Score a short reply

kirundi_brain_info

Paths / version / config

Setup

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_KEY

Run MCP server alone (stdio — Cursor / Claude Desktop)

python server.py

Example 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"
      }
    }
  }
}

Run agent demo

python demo_agent.py "How do I say thank you in Kirundi?"
python demo_agent.py "Quiz me on greetings"

Sample corpus

Bundled under brain/: greetings, courtesy, numbers, food. Point KIRUNDI_BRAIN_DIR at a larger phrase bank when you have one.

Env

Variable

Role

OPENAI_API_KEY

Required for agent demo + ask / grade

KIRUNDI_BRAIN_MODEL

Default gpt-4o-mini

KIRUNDI_BRAIN_DIR

Corpus root (default: ./brain)

KIRUNDI_BRAIN_DATA_DIR

SQLite dir (default: ./data)

Do not commit .env or data/*.sqlite3.

Author

Sama-ndarihttps://www.samandari.dev

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    An educational MCP server example built with FastMCP that demonstrates how to expose tools, resources, and prompts to AI clients. Provides a learning foundation for building MCP servers with Python and integrating them with AI applications like IDEs and chatbots.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server and CLI for step-by-step learning, enabling humans and agents to learn subjects like language tutoring through a structured prompt system.
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    A high-performance personal Model Context Protocol (MCP) server built with the FastMCP Python framework.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Local Leitner flashcard MCP server enabling AI clients to create decks, manage cards, study with spaced repetition, and track progress.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sama-ndari/kirundi-brain-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server