# Contentrain/ai [Health: Active] **Category:** πŸ’» Developer Tools **Repository:** https://github.com/Contentrain/ai **GitHub Stars:** 4 **npm Downloads (last month):** 2571 **Views:** 2 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/contentrain-ai ## Description Local-first MCP server for AI content governance β€” 13 tools for model/content CRUD, validation, normalization, and i18n across any framework. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "ai": { "command": "npx", "args": ["-y","contentrain"] } } ``` ## Documentation & README # Contentrain AI [![npm: @contentrain/mcp](https://img.shields.io/npm/v/%40contentrain%2Fmcp?label=%40contentrain%2Fmcp)](https://www.npmjs.com/package/@contentrain/mcp) [![npm: contentrain](https://img.shields.io/npm/v/contentrain?label=contentrain)](https://www.npmjs.com/package/contentrain) [![npm: @contentrain/query](https://img.shields.io/npm/v/%40contentrain%2Fquery?label=%40contentrain%2Fquery)](https://www.npmjs.com/package/@contentrain/query) [![Agent Skills](https://img.shields.io/badge/Agent_Skills-15_skills-8B5CF6)](https://agentskills.io) [![Docs](https://img.shields.io/badge/docs-ai.contentrain.io-0f172a)](https://ai.contentrain.io) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) [Website](https://contentrain.io) Β· [Docs](https://ai.contentrain.io) Β· [Discord](https://discord.gg/8XbFKfgeZx) Β· [Twitter](https://x.com/Contentrain_io) Β· [LinkedIn](https://www.linkedin.com/company/contentrain) **Extract, govern, and ship structured content from your codebase.** Contentrain helps teams turn hardcoded UI text, docs, and structured content into a governed, reviewable content layer. Agents can extract, create, translate, and update content, while Contentrain enforces schema, Git review, and portable file output. ``` Agent extracts or updates content β†’ Contentrain standardizes β†’ Human reviews β†’ Any platform consumes ``` ## Try it in 30 seconds ```bash npx contentrain init # create .contentrain/ workspace npx contentrain serve # open the local review UI ``` That's it. You now have a governed content workspace with models, validation, review branches, and a local UI β€” no account, no cloud, no proprietary content format. Start here: - [See the 2-minute demo](https://ai.contentrain.io/demo) - [Open the normalize guide](https://ai.contentrain.io/guides/normalize) - [Read the docs](https://ai.contentrain.io) ## What Contentrain is for - **Rescuing hardcoded strings** from existing apps and turning them into structured, translatable content - **Starting new projects with a real content layer** instead of scattering copy across components - **Serving the same content across web, docs, mobile, and backend systems** from plain JSON and Markdown in Git ## What it is not - Not an AI writing app - Not a database-first or dashboard-first CMS replacement for every team - Not a proprietary content runtime that locks your app to one platform ## What it looks like **Before:** Hardcoded strings scattered across your codebase β€” no structure, no translations, no review. ```tsx export default function Hero() { return (

Welcome to our platform

Start your free trial today

) } ``` **After:** Content lives in `.contentrain/`, typed and structured. Source files use i18n keys. ```tsx export default function Hero() { const t = useTranslations() return (

{t('hero.title')}

{t('hero.subtitle')}

) } ``` ```json // .contentrain/content/marketing/hero/en.json { "cta": "Get Started", "subtitle": "Start your free trial today", "title": "Welcome to our platform" } ``` The normalize flow extracts strings, creates models, and patches your source files β€” all through reviewable git branches. This is the strongest entry point into the product: **take the content chaos already in your codebase and turn it into a governed, reviewable content layer.** ## How it works ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ AI Agent │────▢│ MCP (27 tools) │────▢│ .contentrain/β”‚ β”‚ (decides) β”‚ β”‚ (enforces) β”‚ β”‚ (stores) β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚ Review UI / Git β”‚β—€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ (human approves)β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ``` - **Agent** decides what content should exist and where it should come from - **Contentrain** enforces schemas, validation, canonical serialization, and git workflow - **Human** reviews through branches, PRs, or the local Serve UI - **Output** is plain JSON + Markdown that any language or framework can consume ## 4 content kinds | Kind | What it stores | Storage | Example | |---|---|---|---| | **Collection** | Multiple typed entries | JSON object-map | Blog posts, products, team | | **Singleton** | Single entry per locale | JSON object | Hero section, site config | | **Document** | Markdown + frontmatter | `.md` files | Docs, articles, changelog | | **Dictionary** | Flat key-value strings | JSON flat map | i18n translations, UI labels | 27 field types (string, email, url, image, relation, array, object, markdown, ...) with built-in validation. ## Use your content anywhere Content is plain JSON and Markdown. Any language reads it directly. For TypeScript projects, generate a typed SDK: ```bash npx contentrain generate ``` ```ts import { query, singleton, dictionary, document } from '#contentrain' const hero = singleton('hero').locale('en').get() const posts = query('blog-post').locale('en').include('author').all() const labels = dictionary('ui-labels').locale('tr').get('auth.login') const article = document('docs').locale('en').bySlug('getting-started') ``` Works with Nuxt, Next.js, Astro, SvelteKit, Vue, React, Node, Go, Python, Swift, Flutter, and 20+ stacks. ## Why teams use it - **Git-native** β€” every write goes through worktree isolation + review branches - **Normalize flow** β€” scan codebase for hardcoded strings β†’ extract β†’ create i18n-ready content β†’ patch source files - **MCP engine** β€” 27 tools (22 core + 5 media) over stdio or HTTP transport, works with Claude Code, Cursor, Windsurf, or any MCP client - **Provider-agnostic engine** β€” the same tool surface runs over a local worktree, GitHub, or GitLab (self-hosted included) with zero tool-code changes. HTTP transport available for remote drivers such as Studio. - **Canonical serialization** β€” sorted keys, deterministic output, clean git diffs, conflict-free parallel edits - **Agent rules & skills** β€” behavioral policies and step-by-step workflows ship as npm packages - **Serve UI** β€” local web dashboard for browsing models, content, validation, and normalize status - **Framework-agnostic** β€” MCP doesn't know your framework. Agent + skills handle stack-specific logic ## Agent Skills This repo ships 15 [Agent Skills](https://agentskills.io) β€” reusable workflow procedures that any AI coding agent can load on demand. Install all skills to your agent: ```bash npx skills add Contentrain/ai/packages/skills ``` Or install a specific skill: ```bash npx skills add Contentrain/ai/packages/skills --skill contentrain-normalize ``` Skills work with Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, Gemini CLI, and 40+ other agents. See [`AGENTS.md`](https://github.com/Contentrain/ai/blob/HEAD/AGENTS.md) for the full skill catalog and agent guidance. ## Packages | Package | npm | Role | |---|---|---| | [`@contentrain/mcp`](https://github.com/Contentrain/ai/blob/HEAD/packages/mcp) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Fmcp)](https://www.npmjs.com/package/@contentrain/mcp) | 27 MCP tools + stdio / HTTP transport + Local / GitHub / GitLab providers | | [`contentrain`](https://github.com/Contentrain/ai/blob/HEAD/packages/cli) | [![npm](https://img.shields.io/npm/v/contentrain)](https://www.npmjs.com/package/contentrain) | CLI + Serve UI + MCP stdio entrypoint | | [`@contentrain/query`](https://github.com/Contentrain/ai/blob/HEAD/packages/sdk/js) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Fquery)](https://www.npmjs.com/package/@contentrain/query) | Generated TypeScript query SDK | | [`@contentrain/types`](https://github.com/Contentrain/ai/blob/HEAD/packages/types) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Ftypes)](https://www.npmjs.com/package/@contentrain/types) | Shared type definitions + constants | | [`@contentrain/rules`](https://github.com/Contentrain/ai/blob/HEAD/packages/rules) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Frules)](https://www.npmjs.com/package/@contentrain/rules) | Agent quality rules for IDE integration | | [`@contentrain/skills`](https://github.com/Contentrain/ai/blob/HEAD/packages/skills) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Fskills)](https://www.npmjs.com/package/@contentrain/skills) | Workflow procedures + framework guides | | [`@contentrain/wp-import`](https://github.com/Contentrain/ai/blob/HEAD/packages/wp-import) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Fwp-import)](https://www.npmjs.com/package/@contentrain/wp-import) | WordPress WXR / REST β†’ `RawIR` β†’ `.contentrain` store | | [`@contentrain/emitter-astro`](https://github.com/Contentrain/ai/blob/HEAD/packages/emitter-astro) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Femitter-astro)](https://www.npmjs.com/package/@contentrain/emitter-astro) | `ProjectIR` β†’ a complete Astro project | | [`@contentrain/verify`](https://github.com/Contentrain/ai/blob/HEAD/packages/verify) | [![npm](https://img.shields.io/npm/v/%40contentrain%2Fverify)](https://www.npmjs.com/package/@contentrain/verify) | SEO, indexing, link and asset gates for a built site | ## Starter Templates Production-ready templates with Contentrain content models, generated SDK client, and framework-specific patterns: | Template | Framework | Use Case | |---|---|---| | [astro-blog](https://github.com/Contentrain/contentrain-starter-astro-blog) | Astro | Blog / editorial | | [astro-landing](https://github.com/Contentrain/contentrain-starter-astro-landing) | Astro | Landing page | | [next-commerce](https://github.com/Contentrain/contentrain-starter-next-commerce) | Next.js | E-commerce storytelling | | [next-multi-surface-saas](https://github.com/Contentrain/contentrain-starter-next-multi-surface-saas) | Next.js | Marketing + app + docs unified | | [next-saas-dashboard](https://github.com/Contentrain/contentrain-starter-next-saas-dashboard) | Next.js | SaaS dashboard UI copy | | [next-white-label-portal](https://github.com/Contentrain/contentrain-starter-next-white-label-portal) | Next.js | White-label / multi-tenant | | [nuxt-admin-console](https://github.com/Contentrain/contentrain-starter-nuxt-admin-console) | Nuxt | Admin console / operations | | [nuxt-saas](https://github.com/Contentrain/contentrain-starter-nuxt-saas) | Nuxt | SaaS marketing site | | [sveltekit-editorial](https://github.com/Contentrain/contentrain-starter-sveltekit-editorial) | SvelteKit | Editorial / publication | | [vitepress-docs](https://github.com/Contentrain/contentrain-starter-vitepress-docs) | VitePress | Documentation site | Each template is a GitHub template repo β€” click "Use this template" to start. ## Quick reference ```bash npx contentrain init # initialize project npx contentrain serve # local review UI (port 3333) npx contentrain serve --stdio # MCP over stdio for IDE agents npx contentrain validate # check content health npx contentrain generate # generate typed SDK client npx contentrain status # project overview npx contentrain doctor # setup health check npx contentrain reconcile # merge a diverged base branch, content-aware npx contentrain studio login # authenticate with Studio npx contentrain studio connect # connect repo to Studio project ``` ## Documentation - **[2-Minute Demo](https://ai.contentrain.io/demo)** β€” the fastest way to understand the product - **[Getting Started](https://ai.contentrain.io/getting-started)** β€” install, connect an agent, and run the first workflow - **[Normalize Guide](https://ai.contentrain.io/guides/normalize)** β€” the main hardcoded-string rescue flow - **[Ecosystem Map](https://ai.contentrain.io/ecosystem)** β€” package-to-product bridges across AI and Studio - **[Contentrain Studio](https://ai.contentrain.io/studio)** β€” open-core team operations for Git-native structured content, self-hostable or available as managed plans (Starter/Pro/Enterprise) - **[Full Docs](https://ai.contentrain.io)** β€” guides, package reference, and framework integration ## Development ```bash pnpm install && pnpm build && pnpm test pnpm lint # oxlint, warnings treated as errors pnpm docs:check # the docs must not state a number the code disagrees with ``` `pnpm docs:check` runs two guards, both needing `pnpm build` first: - **facts** β€” resolves counts (MCP tools, skills, field types, capability keys) from the packages that own them and compares every place the docs, this README and `AGENTS.md` state one. - **examples** β€” every `@contentrain/*` import in a documented example must name a real export, and no example may mix CommonJS with a top-level `await` (a shape that runs in no module system at all). Both self-test against real defects from this repo's history before they run, so a check that stops catching fails loudly instead of passing silently. See [`RELEASING.md`](https://github.com/Contentrain/ai/blob/HEAD/RELEASING.md) for the versioning and publish workflow. ## Community - [Discord](https://discord.gg/8XbFKfgeZx) β€” chat with the team and community - [GitHub Discussions](https://github.com/Contentrain/ai/discussions) β€” questions and ideas - [Twitter / X](https://x.com/Contentrain_io) β€” product updates and announcements - [LinkedIn](https://www.linkedin.com/company/contentrain) β€” company news - [YouTube](https://www.youtube.com/@contentrain) β€” tutorials and demos - [GitHub Issues](https://github.com/Contentrain/ai/issues) β€” bug reports and feature requests If Contentrain AI is useful to you, consider giving it a star β€” it helps others discover the project. ## License MIT