# Carve

> Carve is an open-source MCP server for files and documents. Parse, lint, format and render Carve markup documents through MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://markup-carve.github.io/carve/
- **Repository:** https://github.com/markup-carve/carve-mcp
- **MCP Registry name:** io.github.markup-carve/carve-mcp
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/carve
