@letar/form-mcp

MCP (Model Context Protocol) server for @letar/forms — gives AI assistants full context about 40+ declarative form field components, form patterns, and ZenStack code generation directives.

Документация на русском

Quick Start

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "form-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@letar/form-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "form-mcp": {
      "command": "npx",
      "args": ["-y", "@letar/form-mcp"]
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "form-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@letar/form-mcp"]
    }
  }
}

What It Provides

Tools (6)

| Tool | Description | | ------------------- | ----------------------------------------------------------- | | list_fields | List all 40+ field types with optional category filter | | get_field_props | Get props, description, and docs for a specific field | | get_field_example | Get TSX code example for a field component | | get_form_pattern | Get complete form examples: CRUD, multi-step, offline, i18n | | get_directives | Get @form.* directive docs for zenstack-form-plugin | | generate_form | Generate form code from a field specification |

Resources (7)

Documentation available via form-docs:// URIs:

• form-docs://fields — 40+ field component reference
• form-docs://form-level — Form.Steps, Form.When, Form.Errors, etc.
• form-docs://schema-generation — FromSchema, AutoFields, Builder
• form-docs://offline — useOfflineForm, sync queue
• form-docs://i18n — FormI18nProvider, localized errors
• form-docs://zenstack — ZenStack integration, @form.* directives
• form-docs://api-reference — Hooks, contexts, types

Prompts (3)

| Prompt | Description | | -------------- | ----------------------------------------------- | | create-form | Template for generating a CRUD form | | add-field | Add a field to an existing form | | migrate-form | Migrate from React Hook Form / Formik / Conform |

Field Categories

| Category | Fields | | ---------------- | ------------------------------------------------------------------------------------------------------------- | | Text | String, Textarea, Password, PasswordStrength, Editable, RichText | | Number | Number, NumberInput, Slider, Rating, Currency, Percentage | | Date | Date, Time, DateRange, DateTimePicker, Duration, Schedule | | Select | Select, NativeSelect, CascadingSelect, Combobox, Autocomplete, Listbox, RadioGroup, RadioCard, SegmentedGroup | | Multi-select | Checkbox, CheckboxCard, Switch, Tags | | Special | Auto, PinInput, OTPInput, ColorPicker, FileUpload, Phone, MaskedInput, Address |

Configuration

Set FORM_MCP_DOCS_PATH environment variable to override the documentation directory path.

Architecture

createFormMcpServer({ docsPath }) → McpServer
  ├── data/loader.ts           — markdown docs parser
  ├── data/field-registry.ts   — 40+ field component registry
  ├── data/pattern-registry.ts — form pattern templates
  ├── data/directive-registry.ts — @form.* directive docs
  └── cli.ts                   — stdio transport entry point

The createFormMcpServer() factory accepts a docsPath parameter, making the same server code work for both local development and the npm package.

Related

• @letar/forms — the form component library
• @letar/zenstack-form-plugin — ZenStack schema-to-form generator