Skip to main content
Glama
EgorKluch

LAML MCP Server

by EgorKluch
README.md
# LAML MCP Server

Parse and validate LAML (YAML-based markup language) documents through Model Context Protocol.

## What it does

- **Load LAML documents** from filesystem via MCP protocol
- **Integrate with Cursor** for LAML file access

## Quick Start

1. Install and build:
```bash
npm install
npm run build
```

2. Configure MCP server in Cursor:

**Option A: Global MCP settings** (recommended)
Create or edit `~/.cursor/mcp_settings.json`:
```json
{
  "mcpServers": {
    "laml-mcp-server": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"]
    }
  }
}
```

**Option B: Project-specific settings**
Add to your Cursor workspace settings:
```json
{
  "mcp": {
    "servers": {
      "laml-mcp-server": {
        "command": "node",
        "args": ["/absolute/path/to/your/project/dist/index.js"]
      }
    }
  }
}
```

3. **Activate server**: In Cursor settings, toggle MCP off/on or restart Cursor

## Usage Examples

### Load LAML Document
```yaml
# Example LAML document
$meta:
  name: 'myDocument'
  purpose: "Document description"
  version: 1.0

content:
  title: 'documentTitle'
  description: "Human readable description"
  enabled: true
```

### Load File Content
The server returns raw file content as string for further processing by your application.

## Available Operations

- **loadLaml**: Load LAML document from file path

## Requirements

- Node.js 18+
- Cursor with MCP support 

TDQS

B3/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly distinct as it is the sole operation available.

Naming Consistency5/5

The single tool name 'loadLaml' uses a consistent verb_noun pattern (load + Laml). Since there is only one tool, naming consistency is inherently perfect with no deviations to assess.

Tool Count2/5

A single tool is too few for a server's purpose, as it severely limits functionality and suggests an incomplete or trivial implementation. This is a borderline case leaning towards inadequacy.

Completeness1/5

The server is severely incomplete for handling LAML documents; it only loads documents without any operations for creating, updating, deleting, querying, or validating them, leaving significant gaps in the domain coverage.

Maintenance

ActivityInactive
ResponsivenessNo issues