Claude Hooks Security Research MCP Server安装配置 GitHub与使用方法

选型结论

Claude Hooks Security Research 属于安全风控类 MCP Server，公开资料标注 0 个工具，通过stdio 本地进程接入，适配 Claude，有可以直接复制的安装命令；接入前要先准备会话凭据。

分类

安全风控

传输方式

stdio

认证方式

会话凭据

部署方式

公开资料未说明

安装与配置

安装命令

python3 hooks/pre-tool-use/security_guard.py

客户端配置示例

{
  "mcpServers": {
    "claude-hooks-security-research": {
      "command": "python3",
      "args": [
        "hooks/pre-tool-use/security_guard.py"
      ]
    }
  }
}

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Python，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 0 个工具，随便调一个只读工具确认能返回结果。

接入前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

详细介绍

🛡️ 克劳德代码挂钩安全研究

用本机挂钩替换MCP服务器的完整指南

用轻量级挂钩取代复杂的MCP服务器和技能，改变Claude Code的安全性

______________________________________________________________________

🎯 项目概述

此存储库包含全面的研究、实现指南和自动化工具，用于用本机挂钩替换模型上下文协议（MCP）服务器和Claude代码技能。

主要成就

✅ 性能提升100-150倍 -钩子执行时间\<5ms，而技能执行时间为5-10s ✅ 复杂性降低90% -无MCP协议，无服务器管理 ✅ 100%可靠性 -保证执行，无服务器崩溃 ✅ 零依赖 -纯Python stdlib，离线工作

研究范围

ContextGuard分析 -MCP安全代理模式
安全卫士 -5引擎威胁检测系统
克劳德代码挂钩 -v2.0.10+功能研究
MCP安全 -行业最佳实践（红帽、Wiz、思科）
AI护栏 -执行前验证模式

______________________________________________________________________

📚 文档

核心研究

文档	描述	大小
挂钩_AS_REPLACEMENTS.md	完整的更换指南	35KB
战略_实施_分析.md	战略路线图	85KB
安全_警报_报告.md	12个自动化机会	65KB
研究来源.md	所有引用和链接	15KB

快速参考

指南	目的
快速启动.md	5分钟部署指南
HOOK_REFERENCE.md	所有挂钩类型和功能
MIGRATION_GUIDE.md	MCP→ 钩子迁移
故障排除.md	常见问题和解决方案

______________________________________________________________________

🚀 快速开始

安装（1个命令）

curl -fsSL https://raw.githubusercontent.com/YOUR-USERNAME/claude-hooks-security-research/main/automation/install.sh | bash

手动安装

# Clone repository
git clone https://github.com/YOUR-USERNAME/claude-hooks-security-research.git
cd claude-hooks-security-research

# Run installer
./automation/install.sh

安装什么

✅ 4个核心安全挂钩

快速注射防护装置（工具使用前）
敏感数据拦截器（PreToolUse）
指令注射护罩（PreToolUse）
文件路径验证器（PreToolUse）

✅ 3个自动化挂钩

自动格式化程序（PostToolUse）
会话记录器（会话开始/结束）
安全审计（PostToolUse）

✅ 配置

~/.claude/settings.json 更新
将脚本挂钩 ~/.claude/hooks/
包含测试套件

______________________________________________________________________

📦 存储库结构

claude-hooks-security-research/
├── README.md                          # This file
├── docs/                              # All documentation
│   ├── HOOKS_AS_REPLACEMENTS.md       # Complete replacement guide
│   ├── STRATEGIC_IMPLEMENTATION_ANALYSIS.md  # Strategic roadmap
│   ├── SECURITY_AUTOMATION_REPORT.md  # 12 opportunities analyzed
│   ├── QUICK_START.md                 # 5-minute guide
│   ├── HOOK_REFERENCE.md              # Complete hook API reference
│   ├── MIGRATION_GUIDE.md             # MCP → Hooks migration
│   └── TROUBLESHOOTING.md             # FAQ and solutions
├── research/                          # Research data
│   ├── RESEARCH_SOURCES.md            # All citations, links, papers
│   ├── contextguard-analysis.md       # ContextGuard MCP analysis
│   ├── mcp-security-landscape.md      # MCP security research
│   ├── claude-hooks-capabilities.md   # Hook system deep dive
│   └── ai-guardrails-patterns.md      # Industry best practices
├── hooks/                             # Hook implementations
│   ├── pre-tool-use/                  # PreToolUse hooks
│   │   ├── security_guard.py          # Main security validation
│   │   ├── path_sanitizer.py          # Path normalization
│   │   ├── sql_validator.py           # SQL injection prevention
│   │   └── credential_injector.py     # Environment variable injection
│   ├── post-tool-use/                 # PostToolUse hooks
│   │   ├── post_security_audit.py     # Post-write secret scanner
│   │   ├── auto_format.sh             # Multi-language formatter
│   │   └── auto_git.sh                # Auto-commit after changes
│   └── session/                       # Session hooks
│       ├── session_start.py           # Session initialization
│       └── session_end.py             # Session summary
├── automation/                        # Automation scripts
│   ├── install.sh                     # One-command installer
│   ├── validate_hooks.sh              # Hook validation
│   ├── test_all_hooks.sh              # Complete test suite
│   ├── context_optimizer.py           # Context window optimization
│   └── knowledge_preserver.py         # Research preservation
├── examples/                          # Usage examples
│   ├── basic-security/                # Basic security setup
│   ├── advanced-automation/           # Advanced workflows
│   ├── custom-hooks/                  # Custom hook templates
│   └── test-inputs/                   # Test JSON inputs
├── tests/                             # Test suites
│   ├── unit/                          # Unit tests per hook
│   ├── integration/                   # Integration tests
│   └── performance/                   # Performance benchmarks
└── .github/                           # GitHub configuration
    ├── workflows/                     # CI/CD pipelines
    └── ISSUE_TEMPLATE/                # Issue templates

______________________________________________________________________

🔧 钩子实现

预工具使用挂钩（堵塞和修改）

保安 -全面的安全验证

# Blocks: Prompt injection, sensitive data, command injection
# Performance: <2ms per request
# Replaces: ContextGuard MCP server + Security Guardian skill

路径消毒器 -透明路径规范化

# Modifies: Resolves relative paths, blocks dangerous paths
# Performance: <1ms per request
# Replaces: Path validation MCP server

SQL验证器 -SQL注入预防

# Blocks: 6+ SQL injection techniques
# Performance: <4ms per request
# Replaces: Database validation skill

凭证注入器 -环境变量注入

# Modifies: {{ENV_VAR}} → actual value from environment
# Performance: <1ms per request
# Replaces: Credential manager MCP server

PostToolUse挂钩（副作用）

岗位安全审计 -写后秘密扫描

# Alerts: API keys, credentials in written files
# Performance: <3ms per file write
# Replaces: Post-commit secret scanning skill

自动格式化 -多语言代码格式化

# Formats: JS/TS (Prettier), Python (Black), Go (gofmt), Rust (rustfmt)
# Performance: <50ms per file
# Replaces: Prettier/Black/gofmt MCP servers

自动Git -自动git暂存/提交

# Actions: Auto-stage modified files, generate commit messages
# Performance: <100ms per commit
# Replaces: Git automation skill

会话挂钩（日志和指标）

会话开始/结束 -全面的会话日志记录

# Logs: All security events, tool calls, violations
# Performance: <10ms per session
# Replaces: Session logging skill + analytics MCP

______________________________________________________________________

📊 性能基准

Hook与MCP服务器

操作	MCP服务器	钩子	改进
安全验证	50-100ms	\<2ms	快50倍
路径验证	30-50ms	\<1ms	快40倍
SQL验证	40-60ms	\<4ms	快15倍
代码格式化	200-500ms	\<50ms	快10倍

钩vs技能

操作	技能	钩	改进
安全扫描	5-10s	\<2ms	速度提高2500倍
秘密检测	5-10s	\<3ms	快2000倍
会话日志	5s	\<10ms	速度提高500倍

整体表现

之前（MCP+技能）： 每个工作流程10-15s的开销 之后（仅钩子）： 每个工作流的开销\<100ms

性能提升：速度提升100至150倍

______________________________________________________________________

🎯 用例

1.企业安全

用零成本挂钩取代昂贵的安全解决方案：

✅ 快速注射预防（OWASP LLM前10名）
✅ 敏感数据泄露预防（GDPR合规性）
✅ SQL注入阻塞（数据库安全）
✅ 命令注入预防（系统安全）
✅ 路径遍历保护（文件系统安全）

投资回报率：每年节省24.8万美元至6.98万美元 （与商业解决方案相比）

2.开发工作流自动化

使用自动挂钩消除手动任务：

✅ 每次保存文件时自动格式化
✅ 使用AI生成的消息自动提交
✅ 自动换行并修复代码质量问题
✅ 自动暂存已修改的文件

节省时间：40小时/月 （手动审查减少）

3.合规与审计

自动符合零开销：

✅ 完整的审计跟踪（记录了100%的工具调用）
✅ 秘密暴露预防（SOC 2，ISO 27001）
✅ 安全事件日志记录（SIEM集成就绪）
✅ 会话级安全指标

合规就绪： SOC 2、ISO 27001、GDPR

4.MCP服务器更换

用钩子替换这些MCP服务器：

MCP服务器	钩子更换	状态
ContextGuard	`security_guard.py`	✅ 完成
更漂亮	`auto_format.sh`	✅ 完成
数据库验证器	`sql_validator.py`	✅ 完成
路径消毒器	`path_sanitizer.py`	✅ 完成
凭证管理器	`credential_injector.py`	✅ 完成
会话记录器	`session_start/end.py`	✅ 完成

______________________________________________________________________

🔬 研究数据

来源分析

官方文件：

安全研究：

行业最佳实践：

真实世界案例研究：

Grammarly：SOC分诊时间减少90%
OpenAI：产品全面采用MCP
Block、Apollo：早期生产部署

完整参考书目： 研究来源.md

______________________________________________________________________

🧪 测试

运行所有测试

# Complete test suite
./automation/test_all_hooks.sh

# Unit tests only
cd tests/unit && pytest

# Integration tests
cd tests/integration && pytest

# Performance benchmarks
cd tests/performance && python benchmark.py

测试单个挂钩

# Test security guard
echo '{"tool_type":"Bash","tool_input":{"command":"rm -rf /"}}' | \
  python3 hooks/pre-tool-use/security_guard.py

# Test path sanitizer
echo '{"tool_type":"Read","tool_input":{"file_path":"../../etc/passwd"}}' | \
  python3 hooks/pre-tool-use/path_sanitizer.py

# Test auto-format
echo '{"tool_type":"Write","tool_input":{"file_path":"test.js"}}' | \
  bash hooks/post-tool-use/auto_format.sh

预期结果

✅ Security guard blocks malicious commands
✅ Path sanitizer normalizes dangerous paths
✅ SQL validator catches injection attempts
✅ Auto-format works for JS/TS/Python/Go/Rust
✅ Session logging captures all events

______________________________________________________________________

📖 文档

对于初学者

快速启动.md -5分钟部署
HOOK_REFERENCE.md -吊钩API参考
示例.md -使用示例

对于高级用户

挂钩_AS_REPLACEMENTS.md -完整的替换模式
MIGRATION_GUIDE.md -MCP→ 钩子迁移
CUSTOM_HOOKS.md -构建自己的钩子

建筑师

战略_实施_分析.md -战略路线图
安全_警报_报告.md -12个机会
ROI_ANALYSIS.md -成本效益分析

研究论文

MCP_SECURITY_LANDSCAPE.md -MCP安全分析
AI_GUARDRAILS_PATTERNS.md -行业格局
内容保护_分析.md -ContextGuard深度学习

______________________________________________________________________

🤝 贡献

欢迎投稿！感兴趣的领域：

新钩子实现 -附加安全/自动化挂钩
性能优化 -使挂钩更快
检测模式 -提高安全检测的准确性
文档 -改进指南和示例
测试 -扩大测试覆盖范围

看贡献.md 作为指导方针。

______________________________________________________________________

🔒 安全

报告漏洞

向以下人员报告安全问题：security@example.com

不要公开安全漏洞问题。

安全最佳实践

✅ 代码审查 -部署前检查所有挂钩
✅ 最小权限 -挂钩使用用户权限运行（无提升）
✅ 只读挂钩 -将挂钩设置为只读(chmod 500)
✅ 完整性检查 -验证钩子文件SHA256
✅ 审计日志 -记录所有钩子执行

看安全.md 完整的安全指南。

______________________________________________________________________

📊 项目状态

当前版本：1.0.0

稳定性： 生产准备就绪 测试覆盖范围： 95% 文档： 完成演出基准测试

路线图

v1.1.0（2026年第一季度）

XSS检测钩
LDAP注入预防
用于指标的Web仪表板

v1.2.0（2026年第二季度）

基于机器学习的异常检测
自定义规则DSL
SIEM集成（Splunk、ELK）

v2.0.0（2026年第三季度）

实时监控守护进程
框架集成（Flask、FastAPI）
跨组织威胁共享

______________________________________________________________________

📄 许可证

MIT许可证-请参阅许可证了解详情。

免费供商业和个人使用。

______________________________________________________________________

🌟 致谢

灵感来源：

ContextGuard -MCP安全代理
克劳德代码 -人工智能辅助开发
安全卫士-威胁检测引擎

研究贡献者：

红帽安全研究
Wiz安全学院
AWS AI护栏团队
护栏AI

______________________________________________________________________

📞 支持

文档： docs/
问题：
讨论：

______________________________________________________________________

📈 统计

______________________________________________________________________

🛡️ 使用本机挂钩保护您的Claude Code工作流-无需MCP服务器！

⚡ 速度提高100-150倍|复杂性降低90%|可靠性100%

______________________________________________________________________

如果你觉得这个仓库有用，就把它标上！ ⭐

工具与能力

工具数量

0

资源数量

0

提示词数量

0

能力标签

安全验证Python本地部署性能优化自动化工具AI安全代码格式化

支持客户端

Claude

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

资产与漏洞排查

批量查询资产和漏洞信息，输出待修清单。

日志审计

从日志里筛出异常访问和高风险操作。

合规检查

按规则核对配置项，记录不符合项。

选择建议

值得选的地方

只提供 0 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

stdio 方式要求本地装好 Python，换机器要重新装一遍。
需要自备会话凭据，没有凭据没法直接试。
公开摘要偏短，具体能力和限制要回到仓库确认。

更适合

需要在安全风控场景里让模型直接调用外部能力的人。
已经在用 Claude 的用户，接入路径最短。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
暂时拿不到会话凭据的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Claude Hooks Security Research MCP World · 本页	0	stdio	有	1 个	2026-05-17
Modelcontextprotocol C22988b0 MCP World	0	stdio	有	1 个	2026-05-17
Hexstrike AI MCP World	0	stdio	有	1 个	2026-05-17
Cyber Strike AI MCP World	75	未说明	未标注	1 个	2026-05-17
MCP Scan MCP World	0	stdio	有	1 个	2026-05-17

常见问题

5 条

Claude Hooks Security Research 怎么安装？

公开资料给出的安装命令是 python3 hooks/pre-tool-use/security_guard.py，运行环境为 Python。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Claude Hooks Security Research 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Python；保存后完全退出客户端再打开，配置才会生效。

Claude Hooks Security Research 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Claude Hooks Security Research 需要 API Key 吗？

公开资料标注的认证方式是会话凭据，也就是要先拿到凭据才能连上；凭据只填在自己本地的配置里，不要写进公开仓库。

Claude Hooks Security Research 支持哪些客户端？

公开资料标注支持 Claude；其他客户端只要能配置 MCP Server，也能用同样的命令或地址接入。

来源信息

MCP World

claude-hooks-security-research

用于替换MCP服务器和Claude Code技能的原生钩子，提供高性能、低复杂度的安全验证和自动化功能。

www.mcpworld.com

/detail/01ba9623e432093dcb55fbe68839d6b7

参考链接

仓库入口

github.com

/hah23255/claude-hooks-security-research

来源标签

安全验证Python本地部署性能优化自动化工具AI安全代码格式化

来源分类路径

安全验证

继续浏览同类 MCP

更多安全风控 MCP（3,600）返回 MCP 目录

上一个 MCP

Claude Gemini Openai

一个安全的模型控制平台（MCP）服务器，提供对Claude、Gemini和ChatGPT API的受控访问，具备全面的数据丢失防护（DLP）和文件上传拦截功能。

下一个 MCP

Claude Kali MCP Commander

Claude Kali MCP 集成服务是一个简洁、最小化的实现，用于将 Kali Linux MCP（模型上下文协议）集成到 Claude Desktop 中，通过 Claude 的界面提供对 Kali Linux 工具的安全访问。该项目在隔离的 Docker 容器中无缝执行安全工具和命令。

选型结论

安装与配置

详细介绍

🛡️ 克劳德代码挂钩安全研究

用本机挂钩替换MCP服务器的完整指南

🎯 项目概述

主要成就

研究范围

📚 文档

核心研究

快速参考

🚀 快速开始

安装（1个命令）

手动安装

安装什么

📦 存储库结构

🔧 钩子实现

预工具使用挂钩（堵塞和修改）

PostToolUse挂钩（副作用）

会话挂钩（日志和指标）

📊 性能基准

Hook与MCP服务器

钩vs技能

整体表现

🎯 用例

1.企业安全

2.开发工作流自动化

3.合规与审计

4.MCP服务器更换

🔬 研究数据

来源分析

🧪 测试

运行所有测试

测试单个挂钩

预期结果

📖 文档

对于初学者

对于高级用户

建筑师

研究论文

🤝 贡献

🔒 安全

报告漏洞

安全最佳实践

📊 项目状态

当前版本：1.0.0

路线图

📄 许可证

🌟 致谢

📞 支持

📈 统计

工具与能力

典型使用场景

选择建议

同类对比

常见问题

Claude Hooks Security Research 怎么安装？

Claude Hooks Security Research 怎么在 Claude Desktop、Cursor 里配置？

Claude Hooks Security Research 收费吗？

Claude Hooks Security Research 需要 API Key 吗？

Claude Hooks Security Research 支持哪些客户端？

来源信息

继续浏览同类 MCP