Mcp Server Markdown

mcp-server-markdown

ローカルの Markdown ファイルを検索、ナビゲートし、コンテンツを抽出します。全文検索、セクションの抽出、見出しのナビゲーション、コードブロックの検出、フロントマターの解析に対応しています。

npx mcp-server-markdown

Claude Desktop、Cursor、VS Code Copilot、その他あらゆる MCP クライアントで利用できます。ローカルの .md ファイルを読み込み、認証は不要です。

 

_{remotion-readme-kit で作成したデモ}

理由

Context7 のようなツールは npm のライブラリドキュメントを調べるのに便利ですが、独自のドキュメントには対応していません。プロジェクトの Wiki、社内ナレッジベース、アーキテクチャ決定記録、オンボーディングガイドは、すべてリポジトリ内またはディスク上の Markdown ファイルとして保存されています。ファイルシステム MCP サーバーはそれらのファイルを読み込めますが、単なるテキストとして扱います。見出し、セクション、コードブロックは認識しません。このサーバーなら対応できます。ディレクトリを指定すると、アシスタントはすべてのドキュメントを横断して検索したり、見出しで特定のセクションを抽出したり、目次を一覧表示したり、ナレッジベース内の TypeScript のコード例をすべて見つけたりできます。

ツール

ツール	機能
list_files	ディレクトリ内のすべての .md ファイルを再帰的に一覧表示します（アルファベット順）
search_docs	すべての .md ファイルを全文検索します（大文字と小文字を区別せず、最大 50 件）
get_section	次の同じレベルまたは上位レベルの見出しまで、見出しでセクションを抽出します
list_headings	すべての見出しを目次として一覧表示します
find_code_blocks	フェンス付きコードブロックを検索します。言語による絞り込みも可能です（例：typescript）
get_frontmatter	ファイルの先頭にある YAML フロントマターのメタデータを解析します

クイックスタート

Cursor

.cursor/mcp.json に追加します：

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

Claude Desktop

claude_desktop_config.json に追加します：

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

VS Code

ユーザー設定または .vscode/mcp.json に追加します：

{
  "mcp": {
    "servers": {
      "markdown": {
        "command": "npx",
        "args": ["-y", "mcp-server-markdown"]
      }
    }
  }
}

使用例

• 「./docs 内のすべてのドキュメントから 'authentication' の記載を検索して」
• 「README.md の 'API Reference' セクションを表示して」
• 「CONTRIBUTING.md のすべての見出しを一覧表示して」
• 「docs 内の TypeScript コードブロックをすべて見つけて」
• 「このファイルのフロントマターのメタデータは何？」
• 「アーキテクチャドキュメントの目次を表示して」

エージェントプラグイン

このリポジトリはAgent Plugins 1.0.0 パッケージです。plugin.json、ポータブルな mcp.json、skills/ が MCP サーバーと一緒に提供されます。

Cursor で使うには、リポジトリをクローンし、~/.cursor/plugins/local/mcp-server-markdown にコピーするかシンボリックリンクを作成してから、ウィンドウを再読み込みします。スキルと MCP は「Customize」>「Plugins」に表示されます。

上記の Cursor と VS Code のインストールボタンも引き続き使えます。手動で JSON を設定する場合と同じ npx -y mcp-server-markdown の stdio サーバーが追加されます。

よくある質問

mcp-server-markdown とは何ですか？

ローカルの .md ファイルを検索、ナビゲートする MCP サーバーです。全文検索、見出しによるセクション検索、目次、コードブロック、YAML フロントマターに対応しています。

Context7 とはどう違いますか？

Context7 は npm で公開されているライブラリのドキュメントを取得します。このサーバーは、ディスク上にすでにある Markdown（Wiki、ADR、社内ガイドなど）をインデックス化します。

Filesystem MCP とはどう違いますか？

Filesystem ツールはファイルをそのまま読み込みます。このサーバーは、見出し、セクション、フェンス付きコード、フロントマターを理解します。

Cursor に Agent Plugin としてインストールできますか？

はい。~/.cursor/plugins/local/mcp-server-markdown を使うと、同梱の markdown-search スキルが MCP 設定とともに読み込まれます。

API キーは必要ですか？

いいえ。パスはローカルにあり、エージェントがディレクトリやファイルのパスをツールに渡します。

開発

git clone https://github.com/ofershap/mcp-server-markdown.git
cd mcp-server-markdown
npm install
npm test
npm run build

関連項目

その他の MCP サーバーや開発者向けツールは、私のポートフォリオをご覧ください。

作者

---

_{README Builder で作成した README}

ライセンス

MIT © 2026 Ofer Shapira