Shodan MCP Server

shodan-mcp-服务器

这是一个模型上下文协议 (MCP) 服务器，提供对 Shodan API 的访问。它允许您以编程方式向 Shodan 查询有关设备、漏洞等信息。

目录

• 介绍
• 安装
• 配置
• 与 Node.js 一起使用
• API 文档
  • 获取 IP 信息
  • dns_lookup
  • 获取漏洞
  • cve_info
  • 搜索
• 项目结构
• 贡献
• 执照

介绍

shodan-mcp-server提供了一种简单的方法，可以使用模型上下文协议 (MCP) 将 Shodan 情报集成到您的应用程序中。它提供了多种工具，允许您从 Shodan 查询各种类型的信息。

特征

主机信息：获取有关 IP 地址的详细信息 搜索：使用其搜索语法查询 Shodan 的数据库 DNS 查找：解析域名 CVE 信息：获取有关特定 CVE 漏洞的详细信息

安装

1. 克隆存储库：
   git clone https://github.com/X3r0K/Shodan-MCP-Server.git cd shodan-mcp-server
2. 安装依赖项：
   npm install
3. 构建项目：
   npm run build

配置

1. 从Shodan获取 Shodan API 密钥。
2. 在您的 MCP 设置文件中配置 MCP 服务器（例如~/.config/mcp/settings.json ）：
   { "mcpServers": { "shodan": { "command": "node", "args": ["/path/to/shodan-mcp-server/build/index.js"], "env": { "SHODAN_API_KEY": "<your_shodan_api_key>" }, "disabled": false, "autoApprove": [] } } }
   将<your_shodan_api_key>替换为您的实际 Shodan API 密钥，并将/path/to/shodan-mcp-server为 shodan-mcp-server 目录的实际路径。

与 Node.js 一起使用

您可以使用@modelcontextprotocol/sdk包将 MCP 服务器与 Node.js 一起使用。

1. 安装 MCP SDK：
   npm install @modelcontextprotocol/sdk
2. 使用use_mcp_tool函数调用工具：
   import { use_mcp_tool } from '@modelcontextprotocol/sdk'; async function getIpInfo(ip) { const result = await use_mcp_tool('shodan', 'get_ip_info', { ip }); console.log(result); } getIpInfo('8.8.8.8');

API 文档

获取 IP 信息

获取有关特定 IP 地址的信息。

输入：

输出：

包含有关 IP 地址信息的 JSON 对象。

dns_lookup

对给定域执行 DNS 查找。

输入：

输出：

包含已解析 IP 地址的 JSON 对象。

获取漏洞

跟踪与特定 IP 地址相关的漏洞。

输入：

输出：

包含与 IP 地址相关的漏洞列表的 JSON 对象。

cve_info

检索有关特定 CVE ID 的信息。

输入：

输出：

包含有关 CVE ID 信息的 JSON 对象。

搜索

在 Shodan 中搜索与查询匹配的设备。

输入：

输出：

包含与查询匹配的设备列表的 JSON 对象。

项目结构

执照

麻省理工学院