# Ioc Search MCP Server
English | [简体中文](./README.md) | [繁體中文](./README_ZH-TW.md)
An MCP server for accessing Ioc Search API.
## 🚀 Quick Start with EMCP Platform
**[EMCP](https://sit-emcp.kaleido.guru)** is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!
### Quick Start:
1. 🌐 Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)**
2. 📝 Register and login
3. 🎯 Go to **MCP Marketplace** to browse all available MCP servers
4. 🔍 Search or find this server (`bach-ioc_search`)
5. 🎉 Click the **"Install MCP"** button
6. ✅ Done! You can now use it in your applications
### EMCP Platform Advantages:
- ✨ **Zero Configuration**: No need to manually edit config files
- 🎨 **Visual Management**: Easy-to-use GUI for managing all MCP servers
- 🔐 **Secure & Reliable**: Centralized API key and authentication management
- 🚀 **One-Click Install**: Rich selection of servers in MCP Marketplace
- 📊 **Usage Statistics**: Real-time service call monitoring
Visit **[EMCP Platform](https://sit-emcp.kaleido.guru)** now to start your MCP journey!
---
## Introduction
This is an MCP server for accessing the Ioc Search API.
- **PyPI Package**: `bach-ioc_search`
- **Version**: 1.0.0
- **Transport Protocol**: stdio
## 安装
### 从 PyPI 安装:
```bash
pip install bach-ioc_search
```
### 从源码安装:
```bash
pip install -e .
```
## 运行
### 方式 1: 使用 uvx（推荐，无需安装）
```bash
# 运行（uvx 会自动安装并运行）
uvx --from bach-ioc_search bach_ioc_search
# 或指定版本
uvx --from bach-ioc_search@latest bach_ioc_search
```
### 方式 2: 直接运行（开发模式）
```bash
python server.py
```
### 方式 3: 安装后作为命令运行
```bash
# 安装
pip install bach-ioc_search
# 运行（命令名使用下划线）
bach_ioc_search
```
## Configuration
### API Authentication
This API requires authentication. Please set environment variable:
```bash
export API_KEY="your_api_key_here"
```
### Environment Variables
| Variable | Description | Required |
|----------|-------------|----------|
| `API_KEY` | API Key | Yes |
| `PORT` | N/A | No |
| `HOST` | N/A | No |
### Using with Cursor
Edit Cursor MCP config file `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"bach-ioc_search": {
"command": "uvx",
"args": ["--from", "bach-ioc_search", "bach_ioc_search"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
### Using with Claude Desktop
Edit Claude Desktop config file `claude_desktop_config.json`:
```json
{
"mcpServers": {
"bach-ioc_search": {
"command": "uvx",
"args": ["--from", "bach-ioc_search", "bach_ioc_search"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}
```
## 可用工具
此服务器提供以下工具:
### `ip_address_search`
Provides comprehensive analysis for a given IP address, including associated ASN, geographic location, network details, WHOIS information, and security vendor evaluations. Summarizes malicious, suspicious, harmless, and undetected classifications, enabling effective threat detection and risk assessment.
**端点**: `GET /rapid/v1/ioc/search/ip`
**参数**:
- `query` (string): Example value: 117.131.215.118
---
### `hash_search`
Provides detailed threat analysis for a given hash, including analysis date, reputation, categories, security vendor assessments, threat names, and URL details. Detects malware, suspicious activity, and clean results from various security vendors with statistical summaries.
**端点**: `GET /rapid/v1/ioc/search/hash`
**参数**:
- `query` (string): Example value: 0000059fcb7d4275e2019593617f3b9c8aa568792e3eaf035420ed7dbffd44bc
---
### `domain_search`
Analyzes a given domain to provide insights into DNS records, HTTP certificate details, reputation, security vendor evaluations, and related tags. Includes detailed security classifications and supports identifying malicious or suspicious domains effectively.
**端点**: `GET /rapid/v1/ioc/search/domain`
**参数**:
- `query` (string): Example value: tracking-usopt-cr.com
---
### `url_search`
Provides in-depth threat analysis for a given URL, including reputation scores, categories, security vendor evaluations, threat names, and metadata. Offers detailed insights into malicious, suspicious, and harmless classifications from various sources, helping to identify potential risks effectively.
**端点**: `GET /rapid/v1/ioc/search/url`
**参数**:
- `query` (string): Example value: http://2.56.56.117/zato/Josho.spc
---
## Tech Stack
- **Transport Protocol**: stdio
- **HTTP Client**: httpx
## License
MIT License - See [LICENSE](./LICENSE) file for details.
## Development
This server is generated by [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) tool.
Version: 1.0.0
