MCP Directory

mcp-pandoc vs Filesystem (Reference)

A side-by-side comparison of two Files & Storage servers — tools, transport, auth, maintenance, and copy-paste config for each.

 mcp-pandoc

Document format conversion (Markdown, HTML, LaTeX, DOCX, PDF, and more) via Pandoc over MCP.

Verified
stdio (local)
No auth
Stale
Python
Filesystem (Reference)

Official MCP reference server for secure local filesystem read/write within allowed directories.

Verified
stdio (local)
No auth
TypeScript
CategoryFiles & StorageFiles & Storage
LanguagePythonTypeScript
Transportstdio (local)stdio (local)
AuthNoneNone
GitHub stars50074k
Last commit7 months ago5 months ago
Verified
Actively maintained
Installuvx mcp-pandocnpx -y @modelcontextprotocol/server-filesystem /absolute/path/to/dir
RepoOpen Open

Verdict

Pick mcp-pandoc if you prefer its approach (document format conversion (markdown, html, latex, docx, pdf, and more) via pandoc over mcp).

Pick Filesystem (Reference) if you want the official, vendor-maintained server, and you prefer the more popular, battle-tested option.

Add mcp-pandoc

Install / run
uvx mcp-pandoc

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-pandoc": {
      "command": "uvx",
      "args": [
        "mcp-pandoc"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Add Filesystem (Reference)

Install / run
npx -y @modelcontextprotocol/server-filesystem /absolute/path/to/dir

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "filesystem-reference": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/absolute/path/to/dir"
      ]
    }
  }
}

FAQ

mcp-pandoc or Filesystem (Reference) — which is better?

Pick mcp-pandoc if you prefer its approach (document format conversion (markdown, html, latex, docx, pdf, and more) via pandoc over mcp). Pick Filesystem (Reference) if you want the official, vendor-maintained server, and you prefer the more popular, battle-tested option.

Can I use both mcp-pandoc and Filesystem (Reference)?

Yes — MCP clients let you enable multiple servers at once. Add both configs to your client's mcpServers and use whichever tool fits the task.

Do mcp-pandoc and Filesystem (Reference) work with Claude, Cursor and Windsurf?

Both do. Copy the per-client config below into Claude Desktop, Cursor, or Windsurf.