AI导哈

Claude规则MCP服务器

一个MCP服务器，提供Claude Code技能和规则的服务，支持HTTP和stdio传输方式。

  • by jeremykenedy
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 jeremykenedy/claude-rules-mcp-server

使用说明

Serve 484 skills and 17 rules to any Claude client via MCP

目录

关于

一个MCP（模型上下文协议）服务器，从文件系统读取Claude代码技能和规则，并将其作为工具公开。支持HTTP和stdio传输，可选令牌身份验证和Cloudflare隧道用于远程访问。

特性

  • 提供484种渐进式披露技能（元数据优先，按需提供完整内容）
  • 17条可单独访问或连接的全局规则
  • 跨多个存储库的项目级规则发现
  • 跨所有技能和规则的关键字搜索
  • 监控摘要集成（Gmail和法庭监控）
  • HTTP传输的令牌身份验证
  • 双传输：HTTP用于容器/web，stdio用于Claude Desktop

需求

  • Node.js 20+
  • npm 10+
  • Docker（用于容器部署）

安装

npm（推荐）

npm install claude-rules-mcp

或者直接运行而不安装：

npx claude-rules-mcp init

手册

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

快速开始

运行交互式安装向导：

npx claude-rules-mcp init

向导将遍历传输选择、路径和令牌身份验证。它创造了一个 .env 使用您的配置文件。

然后启动服务器：

npx claude-rules-mcp run

工具

工具 说明
rules_get_manifest 返回完整的技能清单（名称和描述，而不是文件内容）
rules_list_skills 使用可选关键字过滤器列出所有技能
rules_get_skill 按名称读取特定技能的完整SKILL.md
rules_get_skill_references 列出并读取技能的参考文件
rules_list_global_rules 列出所有17个全局规则名称
rules_get_global_rule 按名称读取特定的全局规则
rules_get_global 将所有17个规则文件连接到一个响应中
rules_get_project 读取项目级CLAUDE.md和.CLAUDE/rules/
rules_list_projects 扫描包含.claude/目录的项目
rules_search 跨技能描述和规则内容的关键字搜索
read_monitor_summary 阅读最新的Gmail/法庭监控摘要

配置

变量 默认值 描述
TRANSPORT stdio http 或 stdio
PORT 3456 HTTP端口
CLAUDE_DATA_PATH /data/.claude 通往技能、规则和清单的道路
CLAUDE_PROJECTS_DIR /data/sites 项目目录路径
MCP_SECRET （无） HTTP身份验证令牌（建议用于远程）

Docker部署

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

健康检查：

curl http://localhost:3456/health

Claude桌面设置

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

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

通过SSH进行远程：

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

Claude.ai Web设置

设置>自定义>连接器>+>添加自定义连接器：

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

测试

# 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"}}}'

许可证

此软件包是根据 MIT许可证.

相关 MCP