Skip to main content
Glama
jeremykenedy

Claude Rules MCP Server

by jeremykenedy

Table of Contents

Related MCP server: Skills MCP Server

About

An MCP (Model Context Protocol) server that reads Claude Code skills and rules from the filesystem and exposes them as tools. Supports HTTP and stdio transports with optional token authentication and Cloudflare Tunnel for remote access.

Features

  • Serves 484 skills with progressive disclosure (metadata first, full content on demand)

  • 17 global rules accessible individually or concatenated

  • Project-level rule discovery across multiple repositories

  • Keyword search across all skills and rules

  • Monitor summary integration (Gmail and court monitors)

  • Token authentication for HTTP transport

  • Dual transport: HTTP for containers/web, stdio for Claude Desktop

Requirements

  • Node.js 20+

  • npm 10+

  • Docker (for container deployment)

Installation

npm install claude-rules-mcp

Or run directly without installing:

npx claude-rules-mcp init

Manual

git clone https://github.com/jeremykenedy/claude-rules-mcp-server.git
cd claude-rules-mcp-server
npm install
npm run build

Quick Start

Run the interactive setup wizard:

npx claude-rules-mcp init

The wizard walks through transport selection, paths, and token auth. It creates a .env file with your configuration.

Then start the server:

npx claude-rules-mcp run

Tools

Tool

Description

rules_get_manifest

Returns the full skills manifest (names and descriptions, not file contents)

rules_list_skills

Lists all skills with optional keyword filter

rules_get_skill

Reads the full SKILL.md for a specific skill by name

rules_get_skill_references

Lists and reads reference files for a skill

rules_list_global_rules

Lists all 17 global rule names

rules_get_global_rule

Reads a specific global rule by name

rules_get_global

Concatenates all 17 rule files into one response

rules_get_project

Reads project-level CLAUDE.md and .claude/rules/

rules_list_projects

Scans for projects with .claude/ directories

rules_search

Keyword search across skill descriptions and rule contents

read_monitor_summary

Reads the latest Gmail/court monitor summary

Configuration

Variable

Default

Description

TRANSPORT

stdio

http or stdio

PORT

3456

HTTP port

CLAUDE_DATA_PATH

/data/.claude

Path to skills, rules, and manifest

CLAUDE_PROJECTS_DIR

/data/sites

Path to project directories

MCP_SECRET

(none)

Token for HTTP authentication (recommended for remote)

Docker Deployment

docker build -t claude-rules-mcp:latest .

docker run -d \
  --name claude-rules-mcp \
  --restart unless-stopped \
  -p 3456:3456 \
  -e TRANSPORT=http \
  -e PORT=3456 \
  -e CLAUDE_DATA_PATH=/data/.claude \
  -e CLAUDE_PROJECTS_DIR=/data/sites \
  -e MCP_SECRET=your-secret-token \
  -v /path/to/.claude:/data/.claude:ro \
  -v /path/to/sites:/data/sites:ro \
  claude-rules-mcp:latest

Health check:

curl http://localhost:3456/health

Claude Desktop Setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "claude-rules": {
      "command": "npx",
      "args": ["-y", "claude-rules-mcp", "run"]
    }
  }
}

For remote via SSH:

{
  "mcpServers": {
    "claude-rules": {
      "command": "ssh",
      "args": [
        "user@your-server",
        "cd /path/to/server && TRANSPORT=stdio node dist/index.js"
      ]
    }
  }
}

Claude.ai Web Setup

Settings > Customize > Connectors > + > Add custom connector:

Name: Claude Rules
URL: https://your-domain.com/mcp?token=your-secret-token

Testing

# Health check
curl http://localhost:3456/health

# Test with token
curl -X POST "http://localhost:3456/mcp?token=your-token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'

License

This package is open-sourced software licensed under the MIT license.

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jeremykenedy/claude-rules-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server