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/healthClaude桌面设置
添加 ~/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许可证.
