Simple OSINT Recon MCP Server

简单的OSINT侦察MCP工具

一种作为模型上下文协议（MCP）服务器构建的全面的开源情报（OSINT）侦察工具。该工具提供各种侦察功能，包括IP扫描、BSSID查找、用户名跟踪等。

🚀 特性

• IP端口扫描器：扫描指定范围内的开放端口的IP地址
• 晃动BSSID查找：查询Wigle数据库以获取无线网络信息
• 用户名跟踪器：跨多个平台和服务跟踪用户名

📋 先决条件

• Python 3.8或更高版本
• UV包管理器（推荐）或pip
• OSINT查询的互联网连接
• 外部服务的有效API密钥（如适用）

🛠️ 安装

方法1：使用紫外线（推荐）

# Clone the repository
git clone https://github.com/yourusername/simple-osint-recon-mcp-tool.git
cd simple-osint-recon-mcp-tool

# Install dependencies with UV
uv sync

# Install in development mode
uv pip install -e .

方法2：使用pip

# Clone the repository
git clone https://github.com/yourusername/simple-osint-recon-mcp-tool.git
cd simple-osint-recon-mcp-tool

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

🚀 用法

作为MCP服务器运行

发展模式

# Using UV
uv run dev mcp main.py

# Or directly with Python
python -m mcp main.py

生产模式

# Using UV
uv run mcp main.py

# Or with Python
python main.py

与Claude Desktop集成

要将此工具与Claude Desktop一起使用，请将以下配置添加到您的Claude Desktop设置中：

1. 打开克劳德桌面设置
2. 导航到MCP服务器部分
3. 添加以下配置：

{
  "mcpServers": {
    "simple-osint-recon": {
      "command": "uv",
      "args": ["run", "mcp", "main.py"],
      "cwd": "/path/to/simple-osint-recon-mcp-tool"
    }
  }
}

或者直接使用Python：

{
  "mcpServers": {
    "simple-osint-recon": {
      "command": "python",
      "args": ["main.py"],
      "cwd": "/path/to/simple-osint-recon-mcp-tool"
    }
  }
}

使用Claude API运行

您还可以通过Anthropic API将此工具与Claude集成，方法是将其作为MCP服务器运行，并将其连接到您的Claude应用程序。

🔧 工具功能

1.IP扫描器

扫描指定范围内的开放端口的IP地址。

参数：

• ip_address：要扫描的目标IP地址
• start_port：起始端口号
• end_port：结束端口号

示例用法：

Scan IP 192.168.1.1 from port 80 to 443

2.摆动BSSID查找

使用BSSID查询Wigle数据库中的无线网络信息。

参数：

• bssid：无线接入点的MAC地址

示例用法：

Look up BSSID AA:BB:CC:DD:EE:FF

3.用户名跟踪器

跨多个平台和社交媒体服务跟踪用户名。

参数：

• username：要搜索的用户名

示例用法：

Track username "johndoe123" across platforms

🔐 配置

环境变量

创建一个 .env 项目根目录中的文件，包含以下变量：

# Wigle API Configuration
WIGLE_API_USERNAME=your_wigle_username
WIGLE_API_PASSWORD=your_wigle_password

# Additional API keys for external services
OTHER_API_KEY=your_api_key_here

配置文件

您还可以使用 config.json 其他设置文件：

{
  "timeout": 30,
  "max_threads": 10,
  "default_ports": [22, 23, 53, 80, 110, 143, 443, 993, 995],
  "log_level": "INFO"
}

📁 项目结构

simple-osint-recon-mcp-tool/
├── main.py                 # Main MCP server entry point
├── requirements.txt        # Python dependencies
├── pyproject.toml         # Project configuration
├── README.md              # This file
├── .env.example           # Environment variables template
├── config.json            # Configuration settings
├── tools/                 # Individual tool modules
│   ├── __init__.py
│   ├── ip_scanner.py
│   ├── wigle_tool.py
│   ├── username_tracker.py

🐛 故障排除

常见问题

1. 端口已在使用中：确保您尝试使用的端口未被其他服务占用
2. API关键错误：验证API密钥是否在中正确设置 .env 文件
3. 权限不足：以适当的权限运行网络操作
4. 未找到模块：确保所有依赖项都已正确安装

调试模式

运行带有调试日志记录的工具：

uv run dev mcp main.py --debug

日志

检查中的日志文件 logs/ 详细错误信息的目录。

🤝 贡献

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

⚠️ 免责声明

此工具仅用于教育和授权的安全测试目的。用户有责任确保在扫描或分析任何系统、网络或服务之前获得适当的授权。作者不对任何滥用此工具的行为负责。

🔗 有用的资源

• 模型上下文协议文档
• Claude桌面集成指南
• Wigle API文档
• OSINT最佳实践

📞 支持

电子邮件-imashanilupul@gmail.com

______________________________________________________________________

狩猎快乐！ 🕵️‍♂️