A Model Context Protocol server for development rules and best practices
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"rules-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Rules MCP Server A Model Context Protocol (MCP) server that provides development rules and best practices from markdown files. Similar to Context7's approach, this server dynamically loads rules from markdown files in the `rules/` directory. ## Features - **Simple API**: Only two tools - `get_rules` and `list_rules` - **Dynamic Loading**: Automatically loads any `.md` files from the `rules/` directory - **File Watching**: Automatically reloads rules when files change (optional) - **Metadata Support**: Extracts metadata from markdown files for better organization ## Installation ### From PyPI (Recommended) ```bash pip install rules-mcp-server ``` ### From Source ```bash git clone https://github.com/yourusername/rules-mcp-server.git cd rules-mcp-server pip install -e . ``` ### Prerequisites - Python 3.8+ - pip ## Usage ### With Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "rules": { "command": "rules-mcp-server" } } } ``` ### With Cursor Add to your `~/.cursor/mcp.json`: ```json { "mcpServers": { "rules": { "command": "rules-mcp-server" } } } ``` ### Alternative: Using Python Module ```json { "mcpServers": { "rules": { "command": "python", "args": ["-m", "rules_mcp_server"] } } } ``` ### Local Development ```bash # After installation rules-mcp-server # Or run directly python server.py ``` ## Available Tools ### `get_rules(domain: str)` Get rules and best practices for a specific domain. **Example:** ``` get_rules("react") - Get React development rules get_rules("security") - Get security best practices ``` ### `list_rules()` List all available rule domains with descriptions. **Example:** ``` list_rules() - Shows all available rule domains ``` ## Adding Rules Simply add markdown files to the `rules/` directory. The filename (without `.md`) bec…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.