Skip to main content
Glama

ServerHub

渗透测试样本台账 + SEO 友链投放系统。

  • 台账:公司 → 资产(样本)→ 漏洞 / 载荷 / 凭据 / 附件 / 访问记录,结构化归档,支持 Markdown 报告渲染与凭据加密存储。

  • SEO 投放:投放域名表 + 自管脚本包 + 常驻 worker 异步批次执行,前端实时进度,失败自动登记失效表,域名软删除可恢复。

  • MCP 接入:JSON-RPC 2.0 over HTTP,把全部业务能力以工具形式暴露给外部 AI 客户端。

技术栈

层

选型

后端

Django 6 + SQLite(WAL + busy timeout)

前端

服务端模板 + daisyUI 5(Tailwind 4 CDN)

异步投放

独立 worker 进程(manage.py seo_worker)+ 线程池并行

外部接入

MCP(JSON-RPC 2.0,Bearer Token 鉴权)

部署

uwsgi(回环端口 + nginx 反代)+ nohup worker + crontab 开机自启

Related MCP server: Pentest MCP

快速开始

python -m venv .venv
.venv\Scripts\activate          # Windows;Linux 用 source .venv/bin/activate
pip install -r requirements.txt

# 配置环境变量(复制 .env.example 为 .env 后填写)
#   SECRET_KEY、DEBUG、MCP_TOKEN、MCP_ENABLED 等

python manage.py migrate
python manage.py createsuperuser
python manage.py runserver

环境变量(.env)

变量

说明

SECRET_KEY

Django 密钥(必填)

DEBUG

调试开关

MCP_ENABLED / MCP_TOKEN

MCP 端点开关与 Bearer Token(不配置则禁用)

MCP_ALLOWED_IPS

MCP 来源 IP 白名单(可选)

MCP_UPLOAD_DIR

MCP 上传目录(默认 media/incoming)

SEO_SCRIPT_ROOT

投放脚本包存储根目录(默认 seo_scripts/)

SEO_PYTHON_BIN

执行投放脚本的 Python(留空自动定位)

SEO_WORKER_CONCURRENCY

批次内脚本并发数(默认 3)

SEO 投放系统

设计

  • 投放表 SeoDeploy:要投出去的域名(全域名唯一,a.com 与 a.a.com 各自独立),含链接地址、title、锚文本;is_deleted 软删除——移出投放可随时恢复,历史台账保留。

  • 投放脚本 SeoScript:zip 包上传(必须含入口 update_friend_links.py),解压为独立目录持久保留(session 缓存、依赖、凭据脚本自理);同名覆盖更新。

  • 记录表 SeoDeployRecord:域名 × 脚本投放台账(成功/失败),驱动「只补投未成功」。

  • 失效表 SeoScriptIssue:脚本失败自动登记,未确认修复前不参与后续批次;管理员修复后点「确认修复」恢复。

  • 批次 SeoBatch / SeoBatchScript:一次「开始投放」= 全部启用脚本参与,worker 异步执行,状态全在数据库,页面轮询实时进度(刷新/退出登录不丢进度)。

脚本契约

python update_friend_links.py task.json   # cwd = 脚本目录

task.json 为动作数组,退出码 0 = 成功,stdout/stderr 捕获为日志:

[{"action": "add", "url": "https://a.com/", "anchor": "示例", "title": "示例 - 描述"}]

action 支持 add(幂等:已存在跳过)与 del(按 url 精确匹配删除,不存在跳过)。

运行

# 常驻投放 worker(配合 crontab @reboot 实现开机自启)
nohup <venv>/bin/python manage.py seo_worker >> logs/worker.log 2>&1 &

MCP 接入

端点 POST /mcp,Authorization: Bearer <MCP_TOKEN>。48 个工具:公司 / 资产 / 漏洞 / 载荷 / 凭据(脱敏 + 明文查看留痕)/ 附件(分片上传)/ 访问记录 / SEO 投放(域名软删恢复、脚本包、失效表、批次进度)。详见 [docs/模块/MCP 接入.md](docs/模块/MCP 接入.md)。

目录结构

API/
  models/            业务模型(公司/资产/漏洞/载荷/凭据/附件/访问记录/SEO)
  seo/               投放引擎(脚本包管理、批次执行、域名规范化)
  mcp/               MCP 协议层与工具实现
  apis/              内部接口
  management/commands/seo_worker.py   常驻投放 worker
  migrations/
  tests/             测试(76 用例)
ServerHub/           项目配置(settings/urls/wsgi)
Web/                 前端视图 / 表单 / 模板(daisyUI)
docs/模块/           系统文档(系统总览 / SEO 投放 / MCP 接入)
youqinglianjie-css/  友链模块样式(normalize.css)

测试

python manage.py test

部署(uwsgi + nginx 反代)

  1. 按 uwsgi.ini 启动:uwsgi -d --ini uwsgi.ini(回环端口,nginx 反代对外)

  2. 启动投放 worker 并配置开机自启(见上)

  3. 迁移:python manage.py migrate

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to discover and invoke backend tools over MCP JSON-RPC while enforcing 3-legged OAuth 2.0 identity propagation, role-based access control, and protocol transcoding to REST APIs.
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables authorized penetration testers to run reconnaissance, scanning, brute-force, exploitation, traffic capture, wordlist generation, and client-report workflows through MCP clients, with stdio/HTTP/SSE transport and OIDC bearer authentication.
      164 npm
      GPL 3.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Exposes an OAuth-gated MCP endpoint with 38 governed tools that let web-based AI chat clients read and edit local files, run whitelisted shell commands, search, use Git and SQLite, fetch localhost/intranet APIs, automate Chromium and DevTools, and manage background tasks, ports, clipboard, notifications, and Postman. Local IDEs can connect directly over 127.0.0.1, while remote clients reach the same machine through a secure public ingress.
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables authorized penetration-testing workflows through MCP by exposing tools for network scanning, web fuzzing, subdomain enumeration, vulnerability scanning, brute-force checks, packet capture, and report generation with HTTP/STDIO/SSE transports and bearer/OIDC authentication.
      164 npm
      GPL 3.0