Skip to content
MCP server

Carve

Parse, lint, format and render Carve markup documents through MCP

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.13
Listing updated
3 days ago

About Carve

Carve is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Carve is a markup language with its own syntax for headings, tables with captions and spans, cross-references, footnotes, math and extensions. It is a separate language, not a Markdown extension, and files use the .crv extension. Parsers exist for JavaScript, PHP and Rust and share one set of input and output tests.

This server gives an MCP client the Carve toolchain: parser, linter, formatter and renderers. A document can be rendered as HTML, Markdown, plain text or ANSI terminal text, and the language's own site notes that renders can warn when an output format drops content. File access is enabled only for roots you configure.

It installs globally from npm as @markup-carve/carve-mcp and is MIT licensed. The language itself is at version 0.1, and its site warns that minor releases may change the grammar before 1.0.

Install

Run in a terminal

claude mcp add carve-mcp -- npx -y @markup-carve/carve-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "carve-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@markup-carve/carve-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "carve-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@markup-carve/carve-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

Parse and lint
Check Carve documents for syntax problems.
Format
Normalize documents to a consistent layout.
Four output formats
Render to HTML, Markdown, plain text or ANSI terminal text.
Markdown migration
The language docs include a guide for moving from Markdown.
Configured file roots
File access is limited to roots you set.

Good for

  • Lint Carve release notes before publishing
  • Convert a Carve document to HTML from an agent
  • Migrate Markdown docs to Carve
  • Preview a document as terminal text

Pricing

Open source

MIT licence

Prices change. Check markup-carve.github.io before you buy.

Carve FAQ

How do I install it?

npm install -g @markup-carve/carve-mcp, then run carve-mcp --help.

Is Carve the same as Markdown?

No. It is a separate language with its own syntax.

Can it read any file on disk?

No. File access is enabled only for configured roots.

What licence is it under?

MIT.

Is Carve free?

Yes. Carve is open source, so you can use and self-host it for free.

How do I add Carve to Claude Code?

Run this command in your terminal: claude mcp add carve-mcp -- npx -y @markup-carve/carve-mcp

What are the best alternatives to Carve?

The closest alternatives to Carve are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Carve

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools