pentest-kb
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PENTEST_KB_DB_HOST | Yes | 数据库主机地址 | |
| PENTEST_KB_DB_NAME | No | 数据库名（默认 postgres） | postgres |
| PENTEST_KB_DB_PORT | No | 端口（默认 5432） | 5432 |
| PENTEST_KB_DB_USER | Yes | 数据库用户名 | |
| PENTEST_KB_DB_MAXCONN | No | 连接池最大连接数（可选，默认 10） | 10 |
| PENTEST_KB_DB_PASSWORD | Yes | 数据库密码 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_experienceA | 搜索渗透测试经验库（仅已审批记录）。基于 BM25 相关性排序，支持中文分词。 参数: keyword: 搜索关键词，如 'WAF绕过'、'SQL注入'、'403' tags_filter: 场景标签过滤（可选），如 ['WAF绕过']，仅返回包含全部指定标签的记录 |
| add_experienceB | 往经验库中新增一条渗透测试经验。 参数: title: 经验标题，如 'Nginx 403 绕过' detail: 详细描述，包括漏洞类型、利用过程、关键payload等 scenario_tags: 场景标签列表（可选），如 ['WAF绕过', 'SQL注入'] tool_code: 利用/工具代码（可选） tool_type: 工具类型（可选），如 'sqlmap'、'burp' status: 'draft'（存为待审批草稿，默认）或 'approved'（直接入库） |
| list_all_experiencesA | 分页列出经验库中所有已审批记录的标题。 参数: limit: 每页条数（默认 50，最大 200） offset: 偏移量（默认 0） |
| find_similarA | 查重：查找与给定标题/详情相似的已入库经验，用于避免重复录入。 参数: title: 待查重的标题 detail: 待查重的详情（可选） |
| list_pending_experiencesA | 列出待审批的经验草稿，并提示每条草稿可能重复的已入库记录。 |
| approve_experienceB | 审批通过一条待审批草稿。 参数: experience_id: 草稿的 id merge_with_id: 可选。提供时，将草稿内容合并进指定记录（详情追加、标签合并、工具信息补全），然后删除草稿 |
| reject_experienceA | 拒绝一条待审批草稿（软删除：记录保留，状态置为 rejected，可恢复）。 参数: experience_id: 草稿的 id |
| delete_experienceA | 软删除一条已审批经验（状态置为 deleted，不参与检索，可恢复）。 参数: experience_id: 经验的 id |
| restore_experienceB | 恢复一条软删除的记录：被拒绝的草稿恢复为 draft，被删除的经验恢复为 approved。 参数: experience_id: 记录的 id |
| list_deleted_experiencesA | 列出所有软删除的记录（被拒绝的草稿 + 被删除的经验），便于恢复或彻底清理。 |
| purge_experiencesA | 彻底删除软删除超过指定天数的记录（物理删除，不可恢复，请谨慎）。 参数: days: 保留天数，软删除超过该天数的记录将被物理删除（默认 30） |
| get_experienceC | 按 id 获取一条经验的完整内容（标题、详情、标签、工具代码、状态等）。 参数: experience_id: 经验的 id |
| update_experienceB | 更新一条经验的字段（只更新传入的字段，未传字段保持不变）。修改前自动做脱敏校验。 参数: experience_id: 经验的 id title: 新标题（可选） detail: 新详情（可选） scenario_tags: 新标签列表（可选） tool_code: 新工具代码（可选） tool_type: 新工具类型（可选） status: 新状态（可选，approved/draft/rejected/deleted） |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Most tools have clearly distinct purposes: the three list_* tools are scoped by status (all/pending/deleted), and search vs. list vs. find_similar are distinguishable. However, update_experience can also set status to approved/rejected, overlapping with the dedicated approve_experience and reject_experience tools, and the delete/reject/purge triad requires careful reading to tell apart.
All 13 tools follow a consistent snake_case verb_noun pattern (list_*, get_*, add_*, update_*, delete_*, restore_*, approve_*, reject_*, search_experience, find_similar, purge_experiences). No convention mixing.
13 tools is well-scoped for a knowledge base with CRUD, search, moderation workflow, dedup, and soft-delete lifecycle. Each tool earns its place with a distinct role.
Full lifecycle is covered: create/add, get, update, search, paginated listing, approval/rejection moderation, dedup checking, soft-delete, restore, and physical purge. No obvious dead ends for the stated domain.