Mcp Shodan

🚀 MCP（恶意代码防护）服务器模块

本项目是一个借助Shodan API构建的MCP（恶意代码防护）服务器模块。它具备丰富功能，涵盖DNS解析、反向DNS查询、IPv4地理位置定位以及CVE和CPE漏洞信息查询等，能为恶意代码防护工作提供有力支持。

🚀 快速开始

📦 安装指南

1. 全局安装：

   npm install mcp-shodan@latest -g
   

2. 创建配置文件：

   # 在默认位置创建config.json
   mcp-shodan init-config
   # 自定义路径创建配置文件
   mcp-shodan init-config --path /custom/path/config.json
   

配置

将以下内容添加到你的Claude Desktop配置文件中：

{
"mcpServers": {
"shodan": {
"command": "mcp-shodan",
"env": {
"SHODAN_API_KEY": "your-actual-api-key-here"
}
}
}
}

启动

1. 使用全局安装的配置启动：

   mcp-shodan start
   

2. 使用自定义路径的配置启动：

   mcp-shodan start --path /custom/path/config.json
   

✨ 主要特性

本项目支持以下功能模块：

💻 使用示例

基础用法

DNS解析

{
"dns_lookup": {
"hostnames": ["google.com", "example.com"]
}
}

返回格式为：

{
"resolve": {
"google.com": "172.217.14.206",
"example.com": "93.184.216.3"
}
}

反向DNS查询

{
"reverse_dns": {
"ips": ["172.217.14.206", "93.184.216.3"]
}
}

返回格式为：

{
"reverse": {
"172.217.14.206": "google.com",
"93.184.216.3": "example.com"
}
}

IPv4地理位置定位

{
"ip_geo": {
"ips": ["172.217.14.206", "93.184.216.3"]
}
}

返回格式为：

[
{
"ip": "172.217.14.206",
"city": "Mountain View",
"region": "California",
"country_name": "美国",
"latitude": 37.3568,
"longitude": -122.090
},
{
"ip": "93.184.216.3",
"city": "Ermont",
"region": "Île-de-France",
"country_name": "法国",
"latitude": 48.95,
"longitude": 2.07
}
]

CVE查询

{
"cve_search": {
"cves": ["CVE-2013-0809", "CVE-2015-5606"]
}
}

返回格式为：

[
{
"cve_id": "CVE-2013-0809",
"summary": "Java反序列化漏洞，影响多个版本的Oracle Java SE。",
"severity": "高危"
},
{
"cve_id": "CVE-2015-5606",
"summary": "Adobe Flash Player远程代码执行漏洞。",
"severity": "严重"
}
]

CPE匹配

{
"cpe_match": {
"cpes": ["cpe:/a:apple:safari", "cpe:/o:microsoft:windows"]
}
}

返回格式为：

[
{
"cpe": "cpe:/a:apple:safari",
"vendors": ["Apple"],
"products": ["Safari"]
},
{
"cpe": "cpe:/o:microsoft:windows",
"vendors": ["Microsoft"],
"products": ["Windows"]
}
]

🔧 错误处理

参数错误

{
"error": {
"code": 400,
"message": "参数格式无效。"
}
}

API调用失败

{
"error": {
"code": 503,
"message": "无法连接到Shodan服务。"
}
}

📚 详细文档

项目结构

mcp-shodan/
├── src/                 # 源代码目录
│   ├── main.js          # 主程序入口
│   └── modules/         # 功能模块
│       ├── dns_lookup.js    # DNS解析功能
│       └── reverse_dns.js  # 反向DNS查询功能
├── config/              # 配置文件目录
│   └── config.json      # 默认配置文件
└── package.json        # 项目依赖管理

使用说明

初始化配置文件

mcp-shodan init-config [--path <路径>]
# 示例：
$ mcp-shodan init-config --path /custom/path

启动服务

mcp-shodan start [--path <路径>]
# 示例：
$ mcp-shodan start

版本历史

贡献指南

提交代码

git clone https://github.com/yourusername/mcp-shodan.git
cd mcp-shodan
npm run dev

创建问题

在GitHub上创建新问题：https://github.com/yourusername/mcp-shodan/issues

📄 许可证

本项目使用MIT许可证，具体内容请参考LICENSE文件。

感谢您对该项目的支持！如果有任何问题，请随时联系维护人员。