MarkView MCP server
io.github.paulhkang94/markview·v1.7.2·38 starsNative macOS markdown preview with MCP server for Claude Code. Swift/SwiftUI, no Electron.
38 stars107 downloads/wk
Reviews
Write oneNobody has reviewed MarkView yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
MarkView tools (9, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_changed_filesList all changed files in a git repository (staged, unstaged, and untracked).
get_word_countCount words, characters, lines, and estimated tokens in markdown content.
lint_contentLint raw markdown content using MarkView's built-in linter. Returns line-by-line
lint_fileLint a markdown file using MarkView's built-in linter. Returns line-by-line
open_fileOpen an existing markdown file from disk in MarkView.
outlineExtract the heading tree from markdown content. Returns a JSON array of headings
preview_markdownRender a markdown string in MarkView's native macOS preview window.
render_diff_filewrite actionRun git diff on a repository and render the output in MarkView with diff2html
render_diff_rawRender a raw unified diff string in MarkView with diff2html syntax highlighting.
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned15/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 49 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (2)
- mediumnpm install lifecycle script present
install.script - mediumnpm install lifecycle script present
install.scriptpackage.json: …ulhkang94/markview", "scripts": { "postinstall": "node scripts/postinstall.js" }, "f…
How MarkView compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 38% of 48,255 servers
- Tools
- 9
- the typical server has 7
- Tools that change things
- 11%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 38
- more than 93% of 28,688 servers
- Downloads a week
- 107
- more than 64% of 12,191 servers with a package
What its tools let an agent do: 7 read · 1 create · 1 change
Install MarkView in Claude Code, Cursor or VS Code
Runs npx -y mcp-server-markview on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add markview -- npx -y mcp-server-markview
What the publisher says
From the MarkView repository's README, as published. We do not edit it. Read it on GitHub
MarkView
&color=green)
Native macOS markdown preview with MCP server for Claude Code. Claude writes markdown — MarkView renders it live, in a real native window, while you work.
Versions: The macOS app (app badge) and the npm MCP wrapper (npm badge) are versioned independently. App releases happen when the Swift binary changes; npm patches happen for MCP server improvements. Both badges always show the latest of each.
Quick Start — Claude Code
One command to wire MarkView into every Claude Code session:
claude mcp add --transport stdio --scope user markview -- npx mcp-server-markviewThat's it. Claude can now call previewmarkdown to render any markdown string in a native macOS window, or openfile to open any .md file directly.
Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:
{
"mcpServers": {
"markview": {
"command": "npx",
"args": ["mcp-server-markview"]
}
}
}Note: MCP servers belong in ~/.claude.json (Claude Code) or claudedesktopconfig.json (Claude Desktop), not ~/.claude/settings.json.
Installation
Homebrew (recommended)
# Full .app with Quick Look extension — Apple notarized, Gatekeeper approved
brew install --cask paulhkang94/markview/markview
# CLI only (builds from source)
brew tap paulhkang94/markview
brew install markviewBuild from source
Prerequisites: macOS 14+, Swift 6.0+ (Xcode Command Line Tools)
git clone https://github.com/paulhkang94/markview.git
cd markview
swift build -c releaseInstall as app (Open With support)
bash scripts/bundle.sh --installCreates MarkView.app in /Applications and registers it with Launch Services for right-click > Open With in Finder. Refuses (unless you pass --force) if a Dock tile is pinned to a build/ or repo-root MarkView.app path, since both are ephemeral dev output.
Install CLI
bash scripts/install-cli.shCreates mdpreview and md symlinks in ~/.local/bin/.
Usage
CLI
mdpreview README.md # Open a file
mdpreview # Open empty editorFinder
Right-click any .md, .markdown, .mdown, .mkd file > Open With > MarkView
Programmatic
open -a MarkView README.mdFeatures
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
MarkView: common questions
- Is MarkView MCP server safe?
- Mostly: it is graded B (72/100). Read the MarkView safety report
- How do I install MarkView?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does MarkView need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is MarkView maintained?
- The last commit was 52 days ago (2026-09-13). The latest release is v1.7.2.
- How does MarkView compare with other MCP servers?
- safety score 72/100 (higher than 38% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 11% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.