InfoBlox MCP和Claude集成-安全强化

企业级InfoBlox DDI管理与Claude AI集成，具有全面的安全强化、输入验证和灵活的Python版本支持。

🚀 快速开始

一个命令设置（推荐）🌟

# Clone the repository
git clone https://github.com/tshoush/20251012InfoBloxMCPandClaudeInteg.git
cd 20251012InfoBloxMCPandClaudeInteg

# Run master setup script - does everything!
./setup.py

就是这样！ 主设置脚本将：

✅ 指导您完成配置（InfoBlox+Claude凭据）
✅ 创建Python虚拟环境
✅ 安装所有依赖项
✅ 在Claude Desktop中配置MCP服务器（可选，仅限macOS/Windows）
✅ 构建RAG知识库（可选）
✅ 运行测试以验证安装
✅ 将配置保存到.env文件

注： MCP通过CLI在所有平台上运行(claude-chat-mcp.py).Claude Desktop自动配置仅适用于macOS/Windows。

总设置时间：3-5分钟

快速选项

# Quick setup (skip optional components)
./setup.py --quick

# Setup without tests
./setup.py --no-tests

# Setup without Claude Desktop auto-configuration
./setup.py --no-mcp

手动设置（替代）

如果您更喜欢手动控制：

# 1. Configure credentials
python claude-chat-rag.py  # Will prompt for configuration

# 2. (Optional) Set up MCP server for Claude Desktop
./setup-mcp.py

# 3. (Optional) Build RAG knowledge base
python infoblox-rag-builder.py

📋 包含内容

核心组件

InfoBlox MCP服务器 -模型上下文协议服务器暴露140多个InfoBlox WAPI端点
Claude聊天界面 -具有不同功能的多个聊天界面
交互式配置 -自动提示缺少设置，保存到.env（新增！🆕)
API确认系统 -具有预览和编辑功能的用户控制API执行（新增！）
RAG系统 -InfoBlox文档的矢量数据库
安全框架 -综合安全模块（第1和第2阶段完成）

交互式配置（新增！🆕)

没有环境变量？没问题！只需运行任何聊天界面，它就会引导您完成设置：

══════════════════════════════════════════════════════════════════
               🔧 Configuration Setup
══════════════════════════════════════════════════════════════════

This script requires environment variables to connect to InfoBlox
and Claude AI. Let's set them up!

InfoBlox Configuration
──────────────────────────────────────────────────────────────────

  Hostname or IP address of your InfoBlox server
InfoBlox Host [192.168.1.224]:

  Username for InfoBlox authentication
InfoBlox Username [admin]:

  Password for InfoBlox authentication
InfoBlox Password: ●●●●●●●●

...

Save configuration to .env file? (yes/no) [yes]:
✓ Configuration saved to: /path/to/.env
✓ Environment variables set for current session
✓ Setup complete! You can now use the chat interfaces.

特征：

✅ 自动检测缺失的设置 -仅提示所需内容
✅ 安全密码输入 -输入时密码被屏蔽
✅ 智能默认值 -按Enter键接受建议值
✅ 保存到.env -可选择保存配置以供重用
✅ 文件权限 -将.env设置为600（仅限所有者读/写）
✅ 备份现有 -在覆盖之前创建.env.backup

API确认系统（新增！）✨

在执行任何InfoBlox API调用之前，用户会看到：

┌─────────────────────────────────────────────────────────────┐
│ 🔍 API Call Preview                                          │
├─────────────────────────────────────────────────────────────┤
│ List networks from InfoBlox                                  │
│                                                              │
│ Method:     GET                                              │
│ Endpoint:   /wapi/v2.13.1/network                           │
│ Username:   admin                                            │
│ Parameters:                                                  │
│   • _max_results: 100                                       │
│                                                              │
│ Curl Equivalent:                                            │
│ curl -X GET -u admin:$INFOBLOX_PASSWORD \                   │
│   'https://192.168.1.224/wapi/v2.13.1/network?...'          │
└─────────────────────────────────────────────────────────────┘

Execute? (yes/no/edit) [yes]:

特征：

✅ 完全可见 -请在执行前查看准确的API调用
✅ 编辑功能 -修改参数和用户名
✅ 随时取消 -中止不必要的操作
✅ 卷曲当量 -复制/粘贴以手动执行
✅ 安全 -密码从未显示（显示$INFOBLOX_Password）
✅ 尽力解析 -从自然语言提示中提取值

看 API-协议指南.md 以获取完整的文档。

安全功能（第1阶段和第2阶段）✅

✅ 零硬编码凭据 -来自环境变量的所有凭据
✅ 输入验证 -命令注入、SQL注入、XSS防御
✅ 可配置SSL -支持自定义CA捆绑包
✅ 结构化日志记录 -应用程序+安全审计日志
✅ 速率限制 -每秒向InfoBlox API发出3次请求
✅ 重试逻辑 -可靠性指数回退
✅ 安全审计跟踪 -记录所有敏感操作

🐍 Python版本支持

违约： Python 3.8.13（兼容RHEL 7.9） 支持： Python 3.8到3.12

# List available Python versions
./deploy.py --list-python

# Use Python 3.11
./deploy.py --local --python-version 3.11

# Use specific Python executable
./deploy.py --local --python-exec /opt/python3.11/bin/python3

看部署.md 获取详细的部署指南。

📊 测试结果

平台	Python	测试	覆盖率	状态
RHEL 7.9	3.8.13	100/102	30%	✅ 生产就绪
macOS	3.12.7	102/102	26%	✅ 开发就绪

🔧 配置

所有配置均通过环境变量进行（无硬编码值）：

# InfoBlox Configuration
export INFOBLOX_HOST="192.168.1.224"
export INFOBLOX_USER="admin"
export INFOBLOX_PASSWORD="your-password"
export WAPI_VERSION="v2.13.1"
export INFOBLOX_VERIFY_SSL="false"  # or path to CA bundle

# Claude API
export ANTHROPIC_API_KEY="sk-ant-..."

# Logging
export LOG_LEVEL="INFO"  # DEBUG, INFO, WARNING, ERROR

# Optional
export INFOBLOX_CA_BUNDLE="/path/to/ca-bundle.crt"
export RAG_DB_PATH="~/.infoblox-rag"

🛠️ 可用工具

聊天界面-我应该使用哪一个？

该项目提供 3种可选聊天界面 具有不同的能力。他们是不管道-选择适合您需求的管道：

界面	工具	文档	最佳选择	速度
claude-chat-infoblox.py	6基础	❌ 否	快速查找，简单查询	⚡ 最快
claude-chat-rag.py	6基础	✅ 是	学习+操作，“如何”问题	🔵 中等
claude-chat-mcp.py	143高级	❌ 否	复杂操作，高级用户	🔵 中等

快速决策指南：

Need to learn InfoBlox concepts?
├─ YES → claude-chat-rag.py (has documentation)
└─ NO → Need advanced operations (create/update/delete)?
         ├─ YES → claude-chat-mcp.py (143 tools)
         └─ NO → claude-chat-infoblox.py (fast & simple)

详细比较： 看 CHAT-INTERFACES-GUIDE.md

1.claude-chat-infoblox.py-快速简单⚡

python claude-chat-infoblox.py

工具： 6个基本的InfoBlox操作
知识： 无文档上下文
最适合： 快速查找，简单查询
例子： “列出所有网络”，“查找IP 192.168.1.50”

2.claude-chat-rag.py-知识增强📚

python claude-chat-rag.py

工具： 6个基本的InfoBlox操作
知识： 通过RAG获取完整的InfoBlox文档
最适合： 学习+操作、讲解
例子： “如何配置DHCP？”，“解释网络容器”
推荐： 大多数用户的最佳起点

3.claude-chat-mcp.py-全功率🚀

python claude-chat-mcp.py

工具： 143个InfoBlox WAPI工具（几乎所有端点）
知识： 无文档上下文
最适合： 操作复杂，功能先进
例子： “创建固定地址”，“更新DNS记录TTL”

独立查询工具（新增！🆕)

用于快速InfoBlox查询的自包含脚本-无需Claude，无需MCP，只需直接访问WAPI：

# Query network information
./infoblox-query.py -n 192.168.1.0/24

# Query IP address details
./infoblox-query.py -i 192.168.1.50

# Query DNS zone information
./infoblox-query.py -z corp.local

# Quiet mode (use saved config, no prompts)
./infoblox-query.py -n 192.168.1.0/24 -q

特征：

✅ 自足 -单个脚本，不依赖于其他项目文件
✅ 交互式配置 -首次运行时使用智能默认值提示输入凭据
✅ 安全存储 -将配置保存到 ~/.infoblox-query.conf （600个权限）
✅ 安静模式 -使用 -q 自动化/脚本标记
✅ 多API编排 -结合多个WAPI调用以获得全面结果
✅ 格式化输出 -彩色编码、结构化信息显示
✅ WAPI 版本 2.13.1 -兼容InfoBlox 9.3

非常适合：

无人工智能开销的快速查找
自动化脚本
CI/CD管道
网络操作故障排除
喜欢直接访问API的用户

实用程序脚本

# Build RAG knowledge base
python infoblox-rag-builder.py

# Explore InfoBlox WAPI
python infoblox-explorer.py

# Run MCP server directly
python infoblox-mcp-server.py

🔌 MCP服务器

CLI使用情况（所有平台）

MCP工作 所有平台 通过CLI界面：

python claude-chat-mcp.py  # 140+ InfoBlox tools via MCP

这适用于macOS、Linux（包括RHEL 7.9）和Windows，不需要Claude Desktop！

克劳德桌面集成（仅限macOS/Windows）

对于Claude Desktop用户，可以进行自动配置：

# Automatically configure MCP server in Claude Desktop
./setup-mcp.py

# Or combined with deployment
./deploy.py --local --setup-mcp

脚本会自动执行以下操作：

✅ 检测Claude Desktop安装（macOS/Windows）
✅ 配置InfoBlox MCP服务器
✅ 设置环境变量
✅ 测试连接

结果： InfoBlox MCP服务器出现在Claude Desktop的🔌 菜单-无需手动配置！

看 MCP-SETUP-GUIDE.md 了解详情。

🏗️ 这一切是如何协同工作的

User: "Show me networks in 192.168.1.0/24"
    ↓
Natural Language → Claude LLM (analyzes intent, extracts parameters)
    ↓
Claude selects tool → infoblox_list_networks
    ↓
API Confirmation System (shows preview with curl equivalent)
    ↓
User confirms → yes
    ↓
InfoBlox WAPI Call → GET /wapi/v2.13.1/network
    ↓
Results returned to user

完整管道：

自然语言输入 -用简明英语查询用户类型
克劳德LLM处理 -AI提取意图和参数
MCP工具选择 -生成结构化工具调用
API确认 -用户看到预览，可以编辑、取消或确认
WAPI执行 -对InfoBlox的安全REST API调用
结果显示 -对用户的格式化响应

看建筑流量.md 了解完整的技术细节。

📚 文档

入门指南

demo.html - 交互式演示 -在浏览器中打开！新🌟)
CHAT-INTERFACES-GUIDE.md - 聊天界面比较 -使用哪一个？新🆕)
用户帐户.md - 操作用例 -真实世界的工作流程（新增！🌟)
STANDALONE-JURY-TOOL.md - 独立查询工具指南 新🆕)
建筑流量.md - 一切如何协同工作 新🌟)
MCP-SETUP-GUIDE.md - 自动MCP设置 新
API-协议指南.md - API确认系统 新
部署.md -带有Python版本选项的部署指南
DDI助理指南.md -使用DDI助手
RAG-SYSTEM-GUIDE.md -RAG系统概述

建筑与设计

建筑设计.md -系统架构
产品要求-文件.md -要求
INFOBLX-MCP-README.md -MCP服务器详细信息

安全与测试

证券审查报告.md -安全审计结果
代码审查报告.md -代码质量审查
REDHAT-7.9测试指南.md -RHEL测试指南

项目状态

第2阶段完成。md -第二阶段竣工总结
建议-摘要.md -改进建议

🏗️ 项目阶段

✅ 第一阶段：安全基础（完成）

安全配置管理(config.py)
输入验证(validators.py)
结构化日志记录(logging_config.py)
83个单元测试通过
79%的代码覆盖率

✅ 第2阶段：集成和可靠性（完成）

将所有6个生产文件迁移到安全模块
添加了速率限制和重试逻辑
命令注入预防
共有102项测试通过
RHEL 7.9上的生产就绪

🔜 第3阶段：高级功能（计划中）

度量和监控
性能优化
高级缓存

🔜 第4阶段：生产强化（计划中）

生产部署指南
灾难恢复程序
性能调整

🔒 安全亮点

第二阶段之前（不安全）

# ❌ INSECURE - Hardcoded credentials
INFOBLOX_HOST = "192.168.1.224"
INFOBLOX_PASSWORD = "infoblox"

# ❌ INSECURE - SSL warnings suppressed
requests.packages.urllib3.disable_warnings()

# ❌ INSECURE - No SSL verification
session.verify = False

第二阶段（安全）之后✅

# ✅ SECURE - Credentials from environment
settings = get_settings()
session.auth = (settings.infoblox_user, settings.infoblox_password)

# ✅ SECURE - Configurable SSL with warnings
session.verify = settings.get_ssl_verify()
settings.display_security_warning()

# ✅ SECURE - Input validation
InputValidator.validate_shell_command(command)

# ✅ SECURE - Rate limiting & retry logic
@sleep_and_retry
@limits(calls=3, period=1)
@retry(stop=stop_after_attempt(3))
def api_call(...):
    ...

🧪 测试

# Run all tests
./deploy.py --local

# Run specific test suite
./deploy.py --local --test-suite phase2

# Run tests without coverage
./deploy.py --local --no-coverage

# Deploy without running tests
./deploy.py --local --no-tests

🤝 贡献

这是一个企业安全项目。关键原则：

✅ 没有硬编码凭据
✅ 所有输入均已验证
✅ 综合录井
✅ 安全第一设计
✅ 安全模块的测试覆盖率为100%

📝 许可证

企业内部项目。

🆘 支持

GitHub问题：问题页面
文件：见 /docs 文件夹
部署帮助：请参阅部署.md

🎯 主要成就

✅ 140+InfoBlox WAPI端点 通过MCP暴露 ✅ 零硬编码凭据 跨所有文件 ✅ 100/102测试通过 在生产环境中使用RHEL 7.9 ✅ 灵活的Python支持 （3.8至3.12） ✅ 企业级安全 -经过验证和测试 ✅ 生产准备就绪 -已部署并验证

______________________________________________________________________

最后更新时间： 2025年10月13日 状态： 生产就绪✅ 阶段： 第二阶段完成 python 3.8.13+（建议RHEL 7.9使用3.8.13）

20251012 Info Blox Mc Pand Claude Integ

快速接入

详细介绍

InfoBlox MCP和Claude集成-安全强化

🚀 快速开始

一个命令设置（推荐）🌟

快速选项

手动设置（替代）

📋 包含内容

核心组件

交互式配置（新增！🆕)

API确认系统（新增！）✨

安全功能（第1阶段和第2阶段）✅

🐍 Python版本支持

📊 测试结果

🔧 配置

🛠️ 可用工具

聊天界面-我应该使用哪一个？

1.claude-chat-infoblox.py-快速简单⚡

2.claude-chat-rag.py-知识增强📚

3.claude-chat-mcp.py-全功率🚀

独立查询工具（新增！🆕)

实用程序脚本

🔌 MCP服务器

CLI使用情况（所有平台）

克劳德桌面集成（仅限macOS/Windows）

🏗️ 这一切是如何协同工作的

📚 文档

入门指南

建筑与设计

安全与测试

项目状态

🏗️ 项目阶段

✅ 第一阶段：安全基础（完成）

✅ 第2阶段：集成和可靠性（完成）

🔜 第3阶段：高级功能（计划中）

🔜 第4阶段：生产强化（计划中）

🔒 安全亮点

第二阶段之前（不安全）

第二阶段（安全）之后✅

🧪 测试

🤝 贡献

📝 许可证

🆘 支持

🎯 主要成就

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP