返回 MCP 目录
public公开dns本地运行

mcp-shodan

ADEO CTI MCP服务器是一个集成了Shodan和VirusTotal API的网络安全分析平台,提供全面的威胁情报和资产分析功能。

article

README

🚀 项目功能模块

本项目功能模块旨在为网络安全相关操作提供支持,借助Shodan和VirusTotal等工具实现特定功能,以下将详细介绍项目的搭建、使用等相关内容。

🚀 快速开始

环境搭建

按照以下步骤搭建项目所需环境:

  1. 设置环境变量:设置所需的环境变量,将 SHODAN_API_KEYVIRUSTOTAL_API_KEY 替换为你自己的API密钥。
    SHODAN_API_KEY=你的_Shodan_API_密钥
    VIRUSTOTAL_API_KEY=你的_VirusTotal_API_密钥
    
  2. 安装依赖项:运行以下命令安装项目依赖项。
    npm install
    
  3. 构建项目:使用以下命令构建项目。
    npm run build
    
  4. 启动服务器:最后,启动项目服务器。
    npm start
    

✨ 主要特性

API速率限制

在使用本项目调用相关API时,需要注意以下速率限制相关内容:

  • 根据你的订阅套餐尊重Shodan API的速率限制。
  • VirusTotal API有单独的速率限制。
  • 尽可能使用批处理操作。
  • 实施适当的请求间隔。

错误处理

服务器能够处理多种错误场景,包括但不限于:

  • 无效的API密钥
  • 速率限制
  • 网络问题
  • 无效参数
  • 缺乏权限

🤝 贡献指南

如果你想为该项目做出贡献,可以按照以下步骤进行:

  1. 叉取仓库。
  2. 创建功能分支。
  3. 提交拉取请求。

📄 许可证

版权所有 © 2024 ADEO网络安全服务。保留所有权利。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端