markdown-rules-mcp

Markdown Rules MCP Server

markdown-rules-mcp brings Markdown project rules into Cursor and other MCP-compatible AI coding tools. Developers can retrieve relevant guidance, control when documents enter context, and inspect or refresh the document index.

Server facts

markdown-rules-mcp

Project

Author
valstro
License
Not specified

Tech

Runtime / language
Not specified
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
26
Last commit
Data as of

Tags

  • Cursor
  • Documentation
  • Markdown
  • agnostic
  • cline
  • cline rules
  • context
  • copilot
  • copilot rules
  • cursor rules
  • docs
  • enterprise
  • large codebase
  • local context
  • local docs
  • local documentation
  • mcp
  • portable
  • roocode
  • roocode rules
  • rules
  • windsurf
  • windsurf rules

Overview

Project guidelines and coding standards stored in Markdown can become context for AI coding conversations through markdown-rules-mcp. Its get_relevant_docs tool retrieves project documentation for a query, using attached file paths and selected relevant documents. The documented default workflow calls for retrieval before the first reply in a chat, with later calls reserved for explicit requests, newly attached files, or an unrelated topic. Developers can replace those usage instructions through a project file or a configured path. For index maintenance, list_indexed_docs reports document counts, previews, and retrieval instructions, while reindex_docs refreshes the index after documentation changes.

YAML frontmatter determines how guidance participates in a conversation: alwaysApply marks global rules, glob patterns associate documents with attached files, and descriptions let the AI choose relevant material. Documents without frontmatter use manual inclusion through an @ reference. Links can bring other files into context or embed a specified line range. Configuration controls the project root, Markdown discovery and exclusion patterns, and whether linked content appears before the referring document. The project supports Cursor and other MCP-compatible AI coding tools.

markdown-rules-mcp setup notes

  • markdown-rules-mcp records stdio only; confirm a network transport upstream before planning remote access.
  • markdown-rules-mcp has no recorded license; confirm reuse terms in its repository.

Related MCP servers