Skip to main content
Glama
chaoslimba-mcp-server

chaoslimba-mcp-server

by lmdrew96

chaoslimba-mcp-server

MCP server for ChaosLimba — provides read-only access to the Romanian language learning platform's database via the Model Context Protocol.

Built with TypeScript, the @modelcontextprotocol/sdk, and PostgreSQL.

Tools

Tool

Description

cl_get_schema

Returns all tables and columns in the database. Good starting point for orientation.

cl_get_grammar_map

Lists grammar features from grammar_feature_map, optionally filtered by CEFR level (A1–C2).

cl_get_prerequisite_chain

Traces the full recursive prerequisite tree for a given grammar feature.

cl_get_content

Browses content items with optional filters for difficulty, topic, and type (audio/text).

cl_coverage_report

Cross-references grammar features against content items to identify coverage gaps.

cl_get_error_patterns

Aggregates anonymized error logs to show where learners struggle most.

cl_get_adaptation_summary

Summarizes fossilization interventions — escalation tiers, counts, and resolution rates.

Related MCP server: maimemo-mcp

Setup

Prerequisites

  • Node.js 18+

  • A PostgreSQL database with the ChaosLimba schema

Install & Build

npm install
npm run build

Environment Variables

Variable

Required

Description

CHAOSLIMBA_DATABASE_URL

Yes

PostgreSQL connection string

Run

CHAOSLIMBA_DATABASE_URL="postgresql://..." npm start

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "chaoslimba": {
      "command": "node",
      "args": ["/absolute/path/to/chaoslimba-mcp-server/dist/index.js"],
      "env": {
        "CHAOSLIMBA_DATABASE_URL": "postgresql://..."
      }
    }
  }
}

Available Tools

20 tools
cl_add_contentAdd Content ItemA

Inserts a new content item into the content_items table. Use during dev sessions to seed reading passages, audio content, etc.

Inputs: type (required), title (required), topic (required), difficultyLevel (required), +10 more.

cl_add_reading_questionAdd Reading QuestionA

Inserts a new reading comprehension question into the reading_questions table. Provide a passage, question, answer options, and the index of the correct answer.

Inputs: level (required), options (required), passage (required), question (required), +2 more.

cl_coverage_reportGrammar Coverage ReportA
Read-only

Cross-references grammar_feature_map against content_items.language_features to show which grammar features have content coverage and which are gaps. The core instructional design audit tool.

Inputs: no named parameters.

cl_get_adaptation_summaryGet Adaptation SummaryA
Read-only

Returns a summary of fossilization interventions — which patterns are being escalated and whether they are resolving. Shows max tier reached, total interventions, and resolution counts.

Inputs: no named parameters.

cl_get_contentGet Content ItemsA
Read-only

Returns content items, optionally filtered by difficulty level, topic, or type. When no difficulty filter is set, results are stratified across difficulty levels for even coverage.

Inputs: type, limit, topic, difficultyLevel.

cl_get_error_patternsGet Error PatternsA
Read-only

Returns aggregated error patterns from error_logs across all users (anonymized). Useful for understanding where learners actually struggle.

Inputs: limit, errorType.

cl_get_feature_exposureGet Feature ExposureA
Read-only

Returns aggregated feature exposure data — how many times each grammar feature has been seen by learners, with correctness rates. Anonymized. Useful for finding undertaught or poorly-performing features.

Inputs: limit, featureKey.

cl_get_generated_content_summaryGet Generated Content SummaryA
Read-only

Returns aggregated stats on AI-generated content — what types are being generated, for which error targets, listening rates, and estimated TTS costs. Anonymized. Useful for auditing the AI tutor's output quality and cost.

Inputs: limit, contentType.

cl_get_grammar_mapGet Grammar Feature MapA
Read-only

Returns all entries from grammar_feature_map, optionally filtered by CEFR level. Shows feature keys, names, categories, descriptions, prerequisites, and sort order.

Inputs: cefrLevel.

cl_get_learning_narrativesGet Learning NarrativesA
Read-only

Returns AI-generated learning narrative summaries — periodic reflections on learner progress with stats. Anonymized. Useful for auditing narrative quality and checking if the reflection system captures meaningful patterns.

Inputs: limit.

cl_get_mystery_itemsGet Mystery ItemsA
Read-only

Returns mystery vocabulary items — words learners encountered and flagged for exploration. Shows word, context, definition, examples, grammar info, and whether the learner has explored it. Useful for understanding organic vocabulary discovery.

Inputs: limit, explored.

cl_get_prerequisite_chainGet Prerequisite ChainA
Read-only

For a given grammar feature, returns its full recursive prerequisite chain so you can audit whether the sequencing is pedagogically sound. Caps depth at 10.

Inputs: featureKey (required).

cl_get_reading_questionsGet Reading QuestionsA
Read-only

Returns reading comprehension questions, optionally filtered by CEFR level. Shows passage text, question, answer options, and correct index. Useful for auditing question quality and level coverage.

Inputs: level, limit.

cl_get_schemaGet Database SchemaA
Read-only

Returns a summary of all tables and their columns in the ChaosLimba database. Use this to orient yourself when first connecting.

Inputs: no named parameters.

cl_get_session_summaryGet Session SummaryA
Read-only

Returns aggregated session data — session counts by type, average duration, and content engagement. All data is anonymized (no user IDs returned). Useful for understanding how learners actually use the app.

Inputs: limit, sessionType.

cl_get_stress_pairsGet Stress Minimal PairsA
Read-only

Returns stress minimal pairs — words where stress placement changes meaning (e.g., CÁsă vs caSĂ). Core pronunciation training data.

Inputs: limit.

cl_get_suggested_questionsGet Suggested QuestionsA
Read-only

Returns AI tutor conversation starter questions, optionally filtered by CEFR level or category. Useful for auditing prompt quality and topic coverage.

Inputs: limit, category, cefrLevel.

cl_get_tts_usageGet TTS UsageA
Read-only

Returns TTS (text-to-speech) usage stats — characters consumed per day. Useful for monitoring costs and usage trends.

Inputs: days.

cl_get_tutor_openingsGet Tutor Opening MessagesA
Read-only

Returns tutor opening messages keyed by self-assessment level. Shows how the AI tutor greets learners at different proficiency levels.

Inputs: selfAssessmentKey.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 20 tools

    Disambiguation5/5

    Every tool targets a distinct data area or action: schema, grammar maps, prerequisite chains, content, coverage, error patterns, adaptations, reading questions, stress pairs, and various analytics. There is no meaningful overlap among the getters or between getters and the two add tools.

    Naming Consistency4/5

    Almost all tools follow the cl_ + verb + noun pattern, e.g., cl_get_content, cl_add_content, cl_get_tts_usage. The single outlier is cl_coverage_report, which omits the get_ verb, causing a minor inconsistency in an otherwise predictable naming convention.

    Tool Count3/5

    20 tools is on the heavy side and falls in the 16-25 range that feels borderline. However, the tools cover a broad educational analytics domain with distinct read-only queries, so each tool serves a reasonably identifiable purpose.

    Completeness4/5

    The read/audit surface is quite comprehensive, covering grammar, content, reading questions, learner behavior, proficiency trends, generated content, and TTS costs. The main gaps are the lack of update/delete operations and write tools for most entities beyond content and reading questions, but that appears intentional for an analytics-and-seeding server.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides tools for connecting to and interacting with various database systems (SQLite, PostgreSQL, MySQL/MariaDB, SQL Server) through a unified interface.
      3
      -
    • A
      license
      A
      quality
      C
      maintenance
      A Model Context Protocol (MCP) server for Firebird databases intended for local use. It reads connection details from FlameRobin's fr_databases.conf so no extra configuration is needed — if you have FlameRobin set up with your Firebird databases, this server works out of the box.
      29
      2
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Read-only MCP server for SQL databases (SQL Server, Postgres, SQLite) with multi-server support and three-layer safety using AST validation and linting.
      MIT