Skip to content

Simple CLI for serving Markdown docs as an MCP server and packaging them for npm.

Notifications You must be signed in to change notification settings

circlesac/mcp-docs-server

Repository files navigation

mcp-docs-server

Share your knowledge as an MCP server.

Have Markdown files (knowledge) you want to share across workspaces or your company? Run them as an MCP docs server so agents can answer directly from your content.

Make your Markdown docs feel alive in coding agents like Cursor and Claude. Add reusable prompt templates to guide users through common workflows. Expose any file type (JSON, images, configs) as browsable MCP resources. When you're ready to roll it out to your team, publish as an npm package for consistent installs—everyone gets the same version with zero extra setup.

Inspired by Mastra’s excellent Mastra Docs Server, which shows how powerful doc-focused MCP servers can be.

If you're using Cursor, click "Add to Cursor" below to add the mcp-docs-server documentation with one click.

Add to Cursor

Or add this configuration to your MCP server settings:

{
  "mcpServers": {
    "mcp-docs-server": {
      "command": "npx",
      "args": ["-y", "@circlesac/mcp-docs-server"]
    }
  }
}

Get started

To get up and running quickly, start with the Getting Started guide. It walks through the simple two-file setup and overview of all three deployment modes.

Three ways to serve your docs

  • Local STDIO - Use serve for local development
  • npm Package - Use publish to distribute via npm
  • Cloudflare Worker - Use cloudflare for remote deployment

See the Commands Overview for a comparison and detailed guides. For configuration options, see the Configuration Reference. Learn how to create reusable prompt templates for common workflows. Expose any file type as browsable resources. Full documentation: docs/index.md.

Contributing

See CONTRIBUTING.md for local setup, testing, and release notes.

About

Simple CLI for serving Markdown docs as an MCP server and packaging them for npm.

Resources

Contributing

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •