go-mcp-server-mds

Overview

This MCP server provides a straightforward way to expose markdown files through the Model Context Protocol. It supports both YAML and TOML frontmatter parsing, making it suitable for documentation repositories. The server implements file system abstraction using Go's fs.FS interface and exposes tools for listing and reading markdown files. Resources are accessible via file:// URIs with proper metadata.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_{server-name}_markdown_files

  Lists all markdown files managed by the server with metadata

  Try:List all markdown files in the repositoryTry:Show me all available markdown documents
• read_{server-name}_markdown_file

  Reads a specific markdown file and returns its content with frontmatter

  Try:Read the content of project.mdTry:Show me the README file with its frontmatter

Comparable tools

Installation

go install github.com/Warashi/go-mcp-server-mds/cmd/mcp-server-mds@latest

mcp-server-mds -path /path/to/markdown/files

{
  "mcpServers": {
    "markdown": {
      "command": "mcp-server-mds",
      "args": ["-path", "/path/to/markdown"]
    }
  }
}

FAQ

What frontmatter formats are supported?

The server supports both YAML (using --- delimiters) and TOML (using +++ delimiters) frontmatter formats.

Can I serve markdown files from a custom file system?

Yes, the server uses Go's fs.FS interface, allowing you to serve markdown files from any implementation of this interface, including embedded file systems.

Compare go-mcp-server-mds with