Shodan MCP Server

shodan-mcp-server

这是一个可访问 Shodan API 的模型上下文协议（MCP）服务。它允许你以编程方式查询 Shodan，获取设备、漏洞等信息。

目录

• 简介
• 安装
• 配置
• 通过 Node.js 使用
• API 文档
  • get_ip_info
  • dns_lookup
  • get_vulnerabilities
  • cve_info
  • search
• 项目结构
• 贡献
• 许可证

简介

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 包，通过 Node.js 使用 MCP 服务。

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 文档

get_ip_info

获取特定 IP 地址的信息。

输入：

{
  "ip": "string" // The IP address to query
}

输出：

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

dns_lookup

对给定域名执行 DNS 查询。

输入：

{
  "hostname": "string" // The hostname to resolve
}

输出：

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

get_vulnerabilities

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

输入：

{
  "ip": "string" // The IP address to query for vulnerabilities
}

输出：

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

cve_info

获取特定 CVE ID 的信息。

输入：

{
  "cve": "string" // The CVE ID to query
}

输出：

包含该 CVE ID 信息的 JSON 对象。

search

在 Shodan 中搜索符合查询条件的设备。

输入：

{
  "query": "string" // The search query
}

输出：

包含符合查询条件的设备列表的 JSON 对象。

项目结构

shodan-mcp-server/
├── .gitignore
├── package.json
├── README.md
├── tsconfig.json
└── src/
    ├── index.ts
    └── index.mts

许可证

MIT