Shodan API服务器

shodan mcp服务器

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

目录

• 引言
• 安装
• 配置
• 使用Node.js
• API文档
  • 获取_信息
  • dns_lookup
  • get_脆弱性
  • 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 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服务器目录的实际路径。

使用Node.js

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

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": "string" // The IP address to query
}

输出：

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

dns_lookup

对给定域执行DNS查找。

输入：

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

输出：

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

get_脆弱性

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

输入：

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

输出：

一个JSON对象，其中包含与IP地址相关的漏洞列表。

cve_info

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

输入：

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

输出：

包含CVE ID信息的JSON对象。

搜索

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

输入：

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

输出：

一个JSON对象，其中包含与查询匹配的设备列表。

项目结构

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

许可证

麻省理工学院