Skip to content
MCP server

gomddoc

Serve a Markdown folder as a docs site and a read-only MCP server for AI agents

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.5.1
Listing updated
3 days ago

About gomddoc

gomddoc is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Point the binary at a folder or a Git URL and it renders a themed, searchable site for readers. Ask the same URL with an Accept: text/markdown header and you get the page source back with generated frontmatter listing its metadata, related pages and navigation neighbours, so a model needs no HTML stripping. The MCP side is read-only and gives agents six capabilities: search the docs, read a page, read a single section, list pages, walk the table of contents and find related pages.

Over stdio it runs as gomddoc mcp ./docs, and the registry entry runs it from a container image. A running gomddoc serve exposes the same tools over HTTP at /_mcp/, behind the same authentication as the site. Git URLs can pin a branch and subdirectory, so an agent can be handed the docs of a project you never cloned.

The README describes a pre-1.0 Go server and static-site generator with llms.txt, a sitemap, Atom feed, Prometheus metrics and a path jail. It is released under the PolyForm Noncommercial License: free for open source, personal, non-profit and education use, with a commercial licence at 490 euros a year per production deployment.

Install

Run in a terminal

claude mcp add gomddoc -- docker run -i --rm ghcr.io/monolithiclab/gomddoc:0.5.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gomddoc": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "gomddoc": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/monolithiclab/gomddoc:0.5.1"
      ]
    }
  }
}

What it does

Markdown content negotiation
Requesting text/markdown returns the page source with generated frontmatter.
Six read-only tools
Agents can search, read pages and sections, list pages, browse the table of contents and find related pages.
Serve any Git repository
Git URLs can pin a branch and subdirectory and are cloned shallowly into memory.
Folder-driven navigation
The sidebar is built from the directory tree with no routing table.
Static build option
gomddoc build writes a site with sitemap, feed, tag pages and a 404 page.
Review annotations
Notes on selected passages are collected as Markdown that names the source file.
Operations basics
Includes Prometheus metrics, health probes, gzip, ETags and graceful shutdown.

Good for

  • Give a coding agent searchable access to a project's docs
  • Publish a folder of Markdown as a readable docs site
  • Hand an agent the docs of a repo you have not cloned
  • Feed an llms.txt-indexed site to AI crawlers
  • Review an agent-written draft by pasting back margin notes

Pricing

Freemium

Free for open source, personal, non-profit and education; commercial licence 490 euros a year per production deployment, excluding VAT

Prices change. Check gomddoc.com before you buy.

gomddoc FAQ

Can the agent edit my docs?

No. The MCP tools are read-only.

How is it installed?

Through Homebrew, an install script, go install or a Docker image on GitHub Container Registry.

Is it free?

It is free for open-source, personal, non-profit and education use. Company use, including internal documentation, needs a commercial licence at 490 euros a year per production deployment.

Does it work over HTTP as well as stdio?

Yes. gomddoc serve exposes the same tools at /_mcp/, behind the site's own authentication.

Is gomddoc free?

gomddoc has a free plan, with paid plans for more usage or features.

How do I add gomddoc to Claude Code?

Run this command in your terminal: claude mcp add gomddoc -- docker run -i --rm ghcr.io/monolithiclab/gomddoc:0.5.1

What are the best alternatives to gomddoc?

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

Alternatives to gomddoc

  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