## 概述
这个n8n工作流将CIRCL Hash Lookup API转换为MCP兼容的接口，专门为AI代理提供哈希查询服务。CIRCL Hash Lookup API允许开发者通过RESTful HTTP接口查询已知文件哈希，支持在线查询并提供离线Bloom过滤器选项用于本地文件检查。
## 核心功能
### MCP服务器架构
– **MCP触发器**: 作为AI代理请求的服务器端点
– **HTTP请求节点**: 处理对https://hashlookup.circl.lu的API调用
– **AI表达式**: 通过`$fromAI()`占位符自动填充参数
– **原生集成**: 直接将响应返回给AI代理
### 可用操作（11个端点）
**批量操作（2个端点）**
– POST /bulk/md5: 批量搜索MD5哈希
– POST /bulk/sha1: 批量搜索SHA1哈希
**子项操作（1个端点）**
– GET /children/{sha1}/{count}/{cursor}: 返回给定SHA1的子项
**信息操作（1个端点）**
– GET /info: 获取数据库信息
**查找操作（3个端点）**
– GET /lookup/md5/{md5}: 查找MD5
– GET /lookup/sha1/{sha1}: 查找SHA-1
– GET /lookup/sha256/{sha256}: 查找SHA-256
**父项操作（1个端点）**
– GET /parents/{sha1}/{count}/{cursor}: 返回给定SHA1的父项
**会话操作（2个端点）**
– GET /session/create/{name}: 创建搜索会话
– GET /session/get/{name}: 获取会话结果
**统计操作（1个端点）**
– GET /stats/top: 获取热门查询
## AI集成特性
### 参数处理
AI代理自动为以下内容提供值：
– 路径参数和标识符
– 查询参数和过滤器
– 请求体数据
– 头部和认证信息
### 响应格式
– 原生hashlookup CIRCL API响应
– 完整数据结构
– 内置n8n HTTP请求错误管理
## 使用示例
将此MCP服务器连接到任何AI代理或工作流：
– **Claude Desktop**: 将MCP服务器URL添加到配置中
– **Cursor**: 将MCP服务器SSE URL添加到配置中
– **自定义AI应用**: 使用MCP URL作为工具端点
– **API集成**: 直接HTTP调用MCP端点
## 设置说明
### 快速设置
1. **导入工作流**: 将此工作流加载到n8n实例中
2. **认证**: 无需认证
3. **激活工作流**: 启用工作流以启动MCP服务器
4. **获取MCP URL**: 从MCP触发器复制webhook URL
5. **连接AI代理**: 在AI代理配置中使用MCP URL
### 使用说明
– 参数通过`$fromAI()`表达式由AI自动填充
– 提供11个API端点作为工具
– 响应保持原始API结构
### 自定义选项
– 根据需要添加数据转换节点
– 实现自定义错误处理
– 添加日志记录或监控节点
– 在任何HTTP请求节点中修改参数默认值
## 优势特点
– **零设置**: 无需参数映射或配置
– **AI就绪**: 内置`$fromAI()`表达式用于所有参数
– **生产就绪**: 原生n8n HTTP请求处理和日志记录
– **可扩展**: 轻松修改或添加自定义逻辑
## 社区支持
该工作流完全免费供社区使用，可在2分钟内完成部署。如需集成指导和自定义自动化，可通过Discord联系作者。
评论(0)