## 概述
这个n8n工作流将BigDataCloud的IP地理位置API转换为MCP兼容的接口，专门为AI代理提供IP地理位置查询服务。该工作流支持两个核心API端点，能够返回详细的IP地理位置信息、置信区域和风险报告。
## 技术架构
### 核心节点组成
– **MCP Server Trigger**: 作为AI代理请求的服务端点
– **HTTP Request Nodes**: 处理对https://api.bigdatacloud.net的API调用
– **AI Expressions**: 通过`$fromAI()`占位符自动填充参数
– **Native Integration**: 直接将响应返回给AI代理
### 可用操作（2个端点）
**数据操作（2个端点）**
1. **IP Geolocation with Confidence Area and Hazard Report API**
– 功能：提供完整的IP地理位置信息，包括置信区域和风险报告
– 参数：
– ip（可选）：IPv4 IP地址，字符串或数字格式
– localityLanguage（可选）：地区名称的首选语言（ISO 639-1格式）
– key（可选）：API密钥
2. **IP Geolocation with Confidence Area API**
– 功能：提供IP地理位置信息及置信区域
– 参数：与完整API相同
## 快速设置指南
### 安装步骤
1. **导入工作流**：将此工作流加载到您的n8n实例中
2. **身份验证**：无需身份验证
3. **激活工作流**：启用工作流以启动MCP服务器
4. **获取MCP URL**：从MCP触发器复制webhook URL
5. **连接AI代理**：在AI代理配置中使用MCP URL
### AI集成特性
**参数处理**：AI代理自动提供以下值：
– 路径参数和标识符
– 查询参数和过滤器
– 请求体数据
– 标头和身份验证
**响应格式**：保持原始IP地理位置API响应的完整数据结构
**错误处理**：内置n8n HTTP请求错误管理
## 使用示例
将此MCP服务器连接到任何AI代理或工作流：
– **Claude Desktop**：将MCP服务器URL添加到配置中
– **Cursor**：将MCP服务器SSE URL添加到配置中
– **自定义AI应用**：使用MCP URL作为工具端点
– **API集成**：直接HTTP调用MCP端点
## 优势特点
– **零设置**：无需参数映射或配置
– **AI就绪**：内置所有参数的`$fromAI()`表达式
– **生产就绪**：原生n8n HTTP请求处理和日志记录
– **可扩展**：轻松修改或添加自定义逻辑
## 技术规格
– **API提供商**：BigDataCloud
– **免费额度**：每月10,000次免费查询
– **更新频率**：
– 地理位置数据每2小时或至少每天重新评估一次
– BGP数据每2小时更新一次
– 注册表数据至少每天更新一次
– 国家对象数据通常每月至少更新一次
## 自定义选项
– 根据需要添加数据转换节点
– 实现自定义错误处理
– 添加日志记录或监控节点
– 在任何HTTP请求节点中修改参数默认值
该工作流专为社区使用而设计，可在2分钟内完成部署。
评论(0)