Serve 484 skills and 17 rules to any Claude client via MCP
目录
- 关于
- 特性
- 需求
- 安装
- 快速开始
- 工具
- 配置
- Docker部署
- Claude桌面设置
- Claude.ai Web设置
- 测试
- 许可证
关于
一个MCP(模型上下文协议)服务器,从文件系统读取Claude代码技能和规则,并将其作为工具公开。支持HTTP和stdio传输,可选令牌身份验证和Cloudflare隧道用于远程访问。
特性
- 提供484种渐进式披露技能(元数据优先,按需提供完整内容)
- 17条可单独访问或连接的全局规则
- 跨多个存储库的项目级规则发现
- 跨所有技能和规则的关键字搜索
- 监控摘要集成(Gmail和法庭监控)
- HTTP传输的令牌身份验证
- 双传输:HTTP用于容器/web,stdio用于Claude Desktop
需求
- Node.js 20+
- npm 10+
- Docker(用于容器部署)
安装
npm(推荐)```bash
npm install claude-rules-mcp
或者直接运行而不安装:```bash
npx claude-rules-mcp init
手册```bash
git clone https://github.com/jeremykenedy/claude-rules-mcp-server.git
cd claude-rules-mcp-server
npm install
npm run build
## 快速开始
运行交互式安装向导:```bash
npx claude-rules-mcp init
向导将遍历传输选择、路径和令牌身份验证。它创造了一个 .env 使用您的配置文件。
然后启动服务器:```bash
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部署```bash
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
健康检查:```bash
curl http://localhost:3456/health
## Claude桌面设置
添加 `~/Library/Application Support/Claude/claude_desktop_config.json`:```json
{
"mcpServers": {
"claude-rules": {
"command": "npx",
"args": ["-y", "claude-rules-mcp", "run"]
}
}
}
通过SSH进行远程:```json
{
"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
测试```bash
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许可证.
