安全Python插件服务器
项目介绍
安全工具MCP - Python版本
这是使用FastMCP库实现的安全工具MCP（模型上下文协议）服务器集合的Python重构版本。
🌟 项目起源及声明
致原作者的感谢
本项目基于**cyproxio/mcp-for-security** JavaScript/TypeScript版本进行了完全的Python重构。我们感谢cyproxio开源了这个优秀的安全工具MCP服务器集合，这对网络安全工具的标准制定做出了重要贡献。
重构说明
⚠️ 重要声明：
- 该项目由Claude 4 AI完全重构，从JavaScript/TypeScript转换为Python
- 尚未通过手动实机测试验证，可能包含运行时错误或功能缺陷
- 代码逻辑基于对原始版本的翻译和适应，但可能存在理解偏差
- 请自行分析代码，谨慎在生产环境中使用
- 如果发现问题，欢迎提交PR或Issues以帮助改进项目
🎯 项目目标
完成20个JavaScript版安全工具MCP服务器到Python版的完全重构，保持：
- ✅ 100% API兼容性（理论上）
- ✅ 相同的功能和参数
- ✅ 独立运行，无相互依赖
- ✅ 详细的中文文档
📁 项目结构
mcp-for-security-python/
├── README.md # 本文件
├── sqlmap-mcp/ # SQL注入测试工具
├── assetfinder-mcp/ # 子域名发现工具
├── waybackurls-mcp/ # 历史URL发现工具
├── crtsh-mcp/ # SSL证书日志查询工具
├── shuffledns-mcp/ # DNS暴力破解工具
├── httpx-mcp/ # HTTP服务检测工具
├── ffuf-mcp/ # Web模糊测试工具
├── nuclei-mcp/ # 漏洞扫描工具
├── nmap-mcp/ # 网络扫描工具
├── masscan-mcp/ # 高速端口扫描工具
├── alterx-mcp/ # 域名变异生成工具
├── arjun-mcp/ # HTTP参数发现工具
├── katana-mcp/ # Web爬虫工具
├── sslscan-mcp/ # SSL/TLS安全扫描工具
├── http-headers-security-mcp/ # HTTP头部安全性检查工具
├── mobsf-mcp/ # 移动应用安全性分析工具
├── scoutsuite-mcp/ # 云安全审计工具
├── smuggler-mcp/ # HTTP请求走私漏洞检测
├── amass-mcp/ # 资产发现与侦察工具
└── wpsscan-mcp/ # WordPress安全扫描工具
🚀 MCP服务器列表
✅ 已完成（20/20 - 100%）
基础工具
-
assetfinder-mcp - 子域名发现工具
- 功能：快速发现目标域的子域名
- 特点：自动清理ANSI颜色代码
-
waybackurls-mcp - 历史URL发现工具
- 功能：从Wayback Machine检索历史URL
- 特点：支持包含/排除子域名选项
-
crtsh-mcp - SSL证书日志查询工具
- 功能：从证书透明度日志中发现子域名
- 特点：API调用，无需本地工具
-
shuffledns-mcp - DNS暴力破解工具
- 功能：高效的DNS解析和暴力破解
- 特点：集成massdns，支持多种模式
-
alterx-mcp - 域名变异生成工具
- 功能：生成用于子域名发现的域名变异
- 特点：支持多种变异模式和自定义模板
扫描工具
-
httpx-mcp - HTTP服务检测工具
- 功能：快速HTTP/HTTPS服务发现
- 特点：丰富的检测选项和并发处理
-
nmap-mcp - 网络扫描工具
- 功能：全面的网络发现和端口扫描
- 特点：完整的nmap参数支持
-
masscan-mcp - 高速端口扫描工具
- 功能：高速大规模端口扫描
- 特点：支持自定义速率和端口范围
-
nuclei-mcp - 漏洞扫描工具
- 功能：基于模板的漏洞扫描
- 特点：多种工具功能，包括标签检索API
-
sslscan-mcp - SSL/TLS安全扫描工具
- 功能：SSL/TLS配置和漏洞检测
- 特点：支持多种SSL/TLS测试选项
模糊测试工具
-
ffuf-mcp - Web模糊测试工具
- 功能：高性能Web目录和参数模糊测试
- 特点：完整的参数配置支持
-
arjun-mcp - HTTP参数发现工具
- 功能：发现隐藏的HTTP GET/POST参数
- 特点：支持多种检测模式和自定义字典
Web爬虫
-
katana-mcp - Web爬虫工具
- 功能：快速Web爬取和端点发现
- 特点：支持JavaScript渲染和深度爬取
漏洞测试
-
sqlmap-mcp - SQL注入测试工具
- 功能：自动化SQL注入检测和利用
- 特点：支持丰富的参数配置
-
smuggler-mcp - HTTP请求走私漏洞检测
- 功能：检测HTTP请求走私漏洞
- 特点：支持CL.TE和TE.CL类型检测
-
wpsscan-mcp - WordPress安全扫描工具
- 功能：WordPress网站安全漏洞扫描
- 特点：支持插件、主题、用户枚举等
安全审计
-
http-headers-security-mcp - HTTP头部安全性检查工具
- 功能：分析HTTP响应头的安全配置
- 特点：基于OWASP标准的安全评估
-
mobsf-mcp - 移动应用安全性分析工具
- 功能：Android/iOS移动应用安全性分析
- 特点：API集成，支持静态和动态分析
-
scoutsuite-mcp - 云安全审计工具
- 功能：多云平台安全配置审计
- 特点：支持AWS、Azure、GCP等云平台
-
amass-mcp - 网络资产发现工具
- 功能：全面的网络资产发现和侦察
- 特点：支持多种数据源和深度侦察
🛠️ 技术特性
统一架构
- 框架：FastMCP 2.0+
- 语言：Python 3.8+
- 异步处理：asyncio
- 类型注解：typing模块
核心功能
- 工具函数：
@mcp.tool()装饰器 - 异步执行：subprocess + asyncio
- 错误处理：统一异常捕获和返回
- 文档支持：完整的docstring和参数描述
实现模式
1. 命令行工具包装（大多数工具）
@mcp.tool()
async def tool_name(target: str, args: List[str] = None) -> str:
cmd = [tool_command] + construct_args(target, args)
process = await asyncio.create_subprocess_exec(...)
stdout, _ = await process.communicate()
return process_output(stdout)
2. API调用集成（crtsh-mcp, mobsf-mcp等）
@mcp.tool()
async def api_tool(target: str) -> str:
async with aiohttp.ClientSession() as session:
async with session.get(api_url) as response:
data = await response.json()
return process_api_data(data)
3. 多种工具功能（nuclei-mcp等）
@mcp.tool()
async def primary_function(...) -> str:
# 主要功能
@mcp.tool()
async def helper_function(...) -> str:
# 辅助功能（如获取配置、标签等）
📦 安装和使用
环境要求
# Python环境
python >= 3.8
# 安装FastMCP
pip install fastmcp>=2.0.0
# 根据需要安装额外依赖
pip install aiohttp>=3.8.0 # 对于基于API的工具
通用使用流程
- 进入工具目录
cd mcp-for-security-python/[tool-name]-mcp/
- 安装依赖
pip install -r requirements.txt
- 启动服务器
# 对于命令行工具（大多数）
python server.py [tool-binary-path]
# 对于API工具（如mobsf-mcp）
python server.py [api-base-url] [api-key]
# 对于脚本工具（如smuggler-mcp）
python server.py [python-path] [script-path]
- 配置MCP客户端
{
"mcpServers": {
"tool-name-mcp": {
"command": "python",
"args": ["/path/to/tool-mcp/server.py", "tool-binary"]
}
}
}
🔧 开发指南
重构标准
- API兼容性：保持与JavaScript版本完全相同的接口
- 功能描述：直接使用原始docstring内容
- 参数处理：支持相同类型的参数和结构
- 错误处理：统一的异常处理和返回格式
- 文档完整性：每个工具都有详细的README.md
代码模板
#!/usr/bin/env python3
"""
工具MCP服务器
工具功能描述。
"""
import sys
import asyncio
from typing import List, Optional
from mcp.server.fastmcp import FastMCP
# 命令行参数处理
if len(sys.argv) < 2:
print("用法：python server.py <tool-binary>", file=sys.stderr)
sys.exit(1)
tool_command = sys.argv[1]
mcp = FastMCP("tool-name", version="1.0.0")
@mcp.tool()
async def tool_function(param: str, optional_param: Optional[List[str]] = None) -> str:
"""工具功能描述"""
# 实现
pass
if __name__ == "__main__":
mcp.run()
🐛 已知问题及限制
潜在问题
- 未实机测试：所有代码均为AI重构，未经实际执行验证
- 依赖兼容性：可能存在Python库版本兼容性问题
- 参数解析：命令行参数构造可能存在问题
- 异常处理：异常处理逻辑可能不够全面
- 性能优化：未针对Python特定特性进行优化
如何贡献
我们欢迎社区贡献来改进此项目：
- 测试验证：在实际环境中测试工具功能
- 问题报告：通过GitHub Issues报告发现的问题
- 代码修复：提交PR修复发现的错误
- 功能改进：优化性能或添加新功能
- 文档改进：改善文档和使用示例
🛡️ 安全提醒
⚠️ 重要安全警告
这些工具仅用于合法的安全测试和研究目的：
- 授权使用：仅在您拥有或明确授权测试的系统上使用
- 法律合规：遵守所有适用的法律法规
- 负责任披露：发现的漏洞应负责任地披露
- 道德使用：旨在提高安全性，而非恶意攻击
- 测试验证：由于缺乏实机测试，请先在安全环境中验证功能
📄 许可证
本项目发布在MIT许可证下。
原始项目cyproxio/mcp-for-security也处于MIT许可证下。
🤝 贡献
欢迎贡献代码以改进项目：
- 分叉项目
- 创建功能分支
- 测试您的更改
- 提交Pull Request
特别欢迎：
- 实机测试反馈
- 错误修复
- 性能优化
- 文档改进
📞 联系
如有疑问或建议，请通过GitHub Issues联系我们。
🙏 致谢
- 感谢**cyproxio**开源了原始的JavaScript MCP服务器集合
- 感谢所有安全工具的原始作者提供了这些优秀的安全工具
- 感谢MCP协议和FastMCP库的开发者
安全工具MCP - Python版本 | 让安全工具更易用且强大 🚀