io.github.zebbern/hacktricks-mcp
Offline full-text search over the HackTricks security wiki, synced every 3 days.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@zebbern/hacktricks-mcpclaude mcp add hacktricks-mcp -- npx -y @zebbern/hacktricks-mcp@0.1.5
{
"mcpServers": {
"hacktricks-mcp": {
"command": "npx",
"args": [
"-y",
"@zebbern/hacktricks-mcp@0.1.5"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
hacktricks-mcp
MCP server that gives AI agents fast, offline full-text search and section-level retrieval over the HackTricks offensive-security wiki.
Unlike grep-based alternatives, this server ships with a pre-built SQLite FTS5 search index (1,000+ pages) inside the package. No install-time clone, no ripgrep dependency, no network access at query time. A GitHub Action re-syncs the index with upstream every 3 days and commits it back to this repo.
Quick start
Requirements: Node.js 22.13 or newer (uses the built-in node:sqlite, zero native dependencies).
Claude Code:
claude mcp add hacktricks -- npx -y @zebbern/hacktricks-mcp
Codex CLI:
codex mcp add hacktricks -- npx -y @zebbern/hacktricks-mcp
Any MCP client (Claude Desktop, Cursor, Kimi, etc.), config JSON:
{
"mcpServers": {
"hacktricks": {
"command": "npx",
"args": ["-y", "@zebbern/hacktricks-mcp"]
}
}
}
As a plugin (bundles the agent skill that teaches efficient usage): this repo is a valid plugin for Claude Code (.claude-plugin/), Codex (.codex-plugin/) and Kimi (kimi-plugin/). Add it from your client's plugin marketplace flow pointing at zebbern/hacktricks-mcp, or for Kimi Work use this plugin link.
Then ask things like:
- "Search HackTricks for kerberoast and give me the attack commands"
- "How do I escalate privileges from the lxd group?"
- "Show me the SSRF section of the pentesting-web pages"
Tools at a glance
| Tool | What it does |
|---|---|
hacktricks_search | Ranked full-text search with snippets, category filter and abbreviation handling (privesc, sqli, rce, ...) |
hacktricks_get_page | Read a page, a single section, or just its code blocks |
hacktricks_get_toc | The wiki category tree, so agents can see where topics live |
All tools are strictly read-only. Full reference: docs/tools.md.
Documentation
- docs/tools.md: complete tool reference with parameters and examples
- docs/architecture.md: how the index and the 3-day sync work
- docs/development.md: local setup, tests, releasing
- docs/agents.md: agent skill, MCP registry and plugin packaging
Security and legal
- The server executes nothing from the wiki; it is a read-only search interface. All queries are parameterized, and user input is escaped before query construction.
- HackTricks content is offensive-security reference material. Use it only on systems you are authorized to test.
- Content belongs to HackTricks / Carlos Polop and contributors; this repo contains derived index data plus original server code (MIT).
Credits
- HackTricks by Carlos Polop and contributors
- Model Context Protocol SDK
الأسئلة الشائعة
ما هو io.github.zebbern/hacktricks-mcp؟
Offline full-text search over the HackTricks security wiki, synced every 3 days.
كيف أثبّت io.github.zebbern/hacktricks-mcp؟
يعمل على جهازك. في Claude Code: claude mcp add hacktricks-mcp -- npx -y @zebbern/hacktricks-mcp@0.1.5. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.zebbern/hacktricks-mcp إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.github.zebbern/hacktricks-mcp مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون io.github.zebbern/hacktricks-mcp؟
ينشره zebbern. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.