MCP Server

Rules MCP MCP Server

Name: Rules MCP MCP Server
Author: io.github.AKR1166

io.github.AKR1166/rules-mcp

Repository Registry

What is the Rules MCP MCP server?

MCP for rules/skills/knowledge evaluation for Cursor, Claude, VS Code, and Antigravity.

How to install Rules MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

LOG_LEVEL
Log level: debug | info | warn | error (logs go to stderr)
SKILLS_PATH
Override path to Markdown/MDC skills directory
KNOWLEDGE_PATH
Override path to knowledge directory
PROFILES_PATH
Override path to agent profiles directory
PROFILE
Active agent profile (default, cursor, claude, …)
RULES_PATH
Override path to legacy YAML rules directory

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "rules-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@akr1166org/rules-mcp"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "SKILLS_PATH": "<YOUR_SKILLS_PATH>",
        "KNOWLEDGE_PATH": "<YOUR_KNOWLEDGE_PATH>",
        "PROFILES_PATH": "<YOUR_PROFILES_PATH>",
        "PROFILE": "<YOUR_PROFILE>",
        "RULES_PATH": "<YOUR_RULES_PATH>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "rules-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@akr1166org/rules-mcp"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "SKILLS_PATH": "<YOUR_SKILLS_PATH>",
        "KNOWLEDGE_PATH": "<YOUR_KNOWLEDGE_PATH>",
        "PROFILES_PATH": "<YOUR_PROFILES_PATH>",
        "PROFILE": "<YOUR_PROFILE>",
        "RULES_PATH": "<YOUR_RULES_PATH>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "rules-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@akr1166org/rules-mcp"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "SKILLS_PATH": "<YOUR_SKILLS_PATH>",
        "KNOWLEDGE_PATH": "<YOUR_KNOWLEDGE_PATH>",
        "PROFILES_PATH": "<YOUR_PROFILES_PATH>",
        "PROFILE": "<YOUR_PROFILE>",
        "RULES_PATH": "<YOUR_RULES_PATH>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "rules-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@akr1166org/rules-mcp"
      ],
      "env": {
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>",
        "SKILLS_PATH": "<YOUR_SKILLS_PATH>",
        "KNOWLEDGE_PATH": "<YOUR_KNOWLEDGE_PATH>",
        "PROFILES_PATH": "<YOUR_PROFILES_PATH>",
        "PROFILE": "<YOUR_PROFILE>",
        "RULES_PATH": "<YOUR_RULES_PATH>"
      }
    }
  }
}

Claude Code

claude mcp add rules-mcp --env LOG_LEVEL=<YOUR_LOG_LEVEL> --env SKILLS_PATH=<YOUR_SKILLS_PATH> --env KNOWLEDGE_PATH=<YOUR_KNOWLEDGE_PATH> --env PROFILES_PATH=<YOUR_PROFILES_PATH> --env PROFILE=<YOUR_PROFILE> --env RULES_PATH=<YOUR_RULES_PATH> -- npx -y @akr1166org/rules-mcp