mcp-server-markdown

MCP server · npm · ★ 8 · graded 2026-10-24Source linked

MCP server for markdown files — search, extract sections, list headings, find code blocks across your docs directory

No outside reports on file

mcp-server-markdown reads and writes local folders; restrict its folder reach, network access, and credentials before installing.

Based on public adoption and transparency signals as of Oct 23, 2026. Our opinion, not a code audit or security guarantee.

Was this verdict for MCP Server Markdown helpful?

What it can access

  • Local filesReads & writes local foldersREVIEW
  • Command executionNo shell command runner notedLOW
  • Network reachConnects to outside service APINOTED
  • CredentialsNo API token requiredLOW
  • Package sourcenpm (mcp-server-markdown)PUBLIC

Inferred from this listing’s public package details and description. Check the project’s source before installing.

Install

npx -y mcp-server-markdown

All setup options ↓

Everything known

We found nothing about this project in the sources we read (last checked 2026-10-30). That does not mean it has no problems.

0 incidents · 0 advisories · 0 news articles · 0 community threads · checked 2026-10-30

Popularity grade: C (from public signals such as stars and downloads, not a code review). Graded 2026-10-24.

Sources we read: OSV, GitHub Advisory Database, CISA Known Exploited Vulnerabilities, 44 security news feeds and our incident library. Last checked 2026-10-30.

Check a specific version →

About MCP Server Markdown

MCP Server Markdown is an MCP server focused on Developer tools and Web & browsing: MCP server for markdown files — search, extract sections, list headings, find code blocks across your docs directory.

It is published on npm as mcp-server-markdown and hosted on GitHub at ofershap/mcp-server-markdown (8 GitHub stars, 61 weekly npm downloads, last repository push on 2026-10-11). Based on its public metadata, its operational scope includes: reads & writes local folders.

Setup

Check these steps against the project’s own instructions before running anything.

Run mcp-server-markdown with --ignore-scripts in claude_desktop_config.json or .cursor/mcp.json:

json
{
  "mcpServers": {
    "mcp-server-markdown": {
      "command": "npx",
      "args": ["-y", "--ignore-scripts", "mcp-server-markdown"]
    }
  }
}

Why this grade

CC — Moderate risk signals

Signal-based grade (2/7 points): listed in several sources, public source code. This reflects adoption and transparency, not a code review.

Popularity and upkeep

34/100
GitHub stars
8
Weekly npm downloads
129
Listing last refreshed
2026-10-29

These are public popularity signals, not a maintenance check. Look at the repository’s commit history and open issues.

Risks to watch for

  • Local folder write access: Can create, edit, or delete files on disk. Restrict its working directory to a dedicated project folder and never mount home or credential directories.
  • Dependency & version pinning: Distributed via npm (mcp-server-markdown). Pin an exact release version or commit SHA rather than floating tags so upstream updates are reviewed first.

How to lower the risk

Least-privilege permissions

  • Give it access only to the specific folders, accounts or projects it needs, never your whole drive or admin account.
  • Use a separate, limited API key or login just for this tool so you can switch it off without affecting anything else.

Network isolation

  • Run it on a work computer or sandbox account, not one holding personal or company-sensitive data.
  • If your IT team can, limit which websites and services it is allowed to contact.

Monitoring

  • Check its activity history or logs weekly at first, and look at what it changed or sent.
  • Turn on alerts for new logins or unusual usage on any account it connects to.

Red flags to watch for

  • It asks for more access than its job requires, or prompts you to paste passwords.
  • It suddenly updates with new owners, or starts contacting unfamiliar websites.

Questions

How do I install MCP Server Markdown?

Run npx -y mcp-server-markdown in your terminal, or add the server entry to your claude_desktop_config.json or .cursor/mcp.json as shown in the Setup section on this page. Full setup docs and environment variables are in github.com/ofershap/mcp-server-markdown.

Are there security reports about MCP Server Markdown?

No reports found for this package in our research (last checked 2026-10-30). MCP Server Markdown currently holds Grade C (Moderate risk signals) based on public adoption and transparency signals. Key risk areas to watch include local folder write access:, dependency & version pinning:.

Is MCP Server Markdown actively maintained?

MCP Server Markdown has 8 GitHub stars and 129 weekly npm downloads, with its latest repository commit pushed on 2026-10-11. Our directory data was last refreshed on 2026-10-29. Check recent commit activity, release tags, and open issues at github.com/ofershap/mcp-server-markdown before pinning it in production.

What are alternatives to MCP Server Markdown?

You can compare MCP Server Markdown side by side with other Search MCP servers in the Related tools section on this page, or use the Compare tool on AgentArmorHQ.

README badge and team notes

Maintain or use MCP Server Markdown? Show its live grade in your GitHub README, docs site, or run a check from the terminal before you install.

AgentArmorHQ Risk Grade C for MCP Server Markdown

GitHub README Markdown:

markdown
[![AgentArmorHQ Risk Grade for MCP Server Markdown](https://agentarmorhq.com/api/badge/ofershap-mcp-server-markdown)](https://agentarmorhq.com/skills/ofershap-mcp-server-markdown)

HTML embed:

html
<a href="https://agentarmorhq.com/skills/ofershap-mcp-server-markdown"><img src="https://agentarmorhq.com/api/badge/ofershap-mcp-server-markdown" alt="AgentArmorHQ Risk Grade for MCP Server Markdown" height="20" /></a>

Terminal check:

terminal
curl -fsSL https://agentarmorhq.com/api/cli | node --input-type=module - check "ofershap-mcp-server-markdown"

Share with your security lead

Need sign-off to use mcp-server-markdown? Copy this note for Slack, a ticket or a pull request.

### AgentArmorHQ Security Review Memo: mcp-server-markdown
- **Listing URL:** https://agentarmorhq.com/skills/ofershap-mcp-server-markdown
- **Type:** App connector
- **Risk Grade:** Grade C (Moderate risk signals)
- **Outside Security Advisories on File:** 0
- **Public Adoption:** 8 GitHub stars, 129 weekly npm downloads

#### Permission & Blast-Radius Signals
- **Local files:** Reads & writes local folders
- **Command execution:** No shell command runner noted
- **Network reach:** Connects to outside service API
- **Credentials:** No API token required
- **Package source:** npm (mcp-server-markdown)

#### Recommended Hardened Setup
- **Command:** `npx -y --ignore-scripts mcp-server-markdown`
- **Controls:** Pin an exact version in `.mcp.json`, scope access to a single workspace folder, and use a least-privilege read-only token where supported.

_Based on public adoption and transparency signals as of Oct 23, 2026. Our opinion, not a code audit or security guarantee._

Key facts

Type
App connector
Publisher
ofershap
Source code
github.com/ofershap/mcp-server-markdown
Install command
npm install mcp-server-markdown
Est. context load
~1.4k tokens / turn (~8 tool schemas, 0.68% of 200k context)
Popularity
8 GitHub stars, 129 weekly npm downloads
Last updated
2026-10-29
Last graded
2026-10-24

Community

Discussions for MCP Server Markdown

Ask questions or share configuration tips. Governed by our Community Rules & Terms.

No posts match this filter yet.

Be the first to ask a question or share a working tip.

Was this listing for MCP Server Markdown helpful?

Check before you install, in Claude

Your assistant answers Block, Review or No known issues for any package before it installs it.

Get this check inside Claude