Chaoslimba 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.

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://..."
      }
    }
  }
}