README

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.

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

chaoslimba-mcp-server

README

chaoslimba-mcp-server

Tools

Setup

Prerequisites

Install & Build

Environment Variables

Run

Claude Desktop Configuration

Recommended Servers